System.Xml.XmlWriter.WriteAttributeString Method

When overridden in a derived class, writes out the attribute with the specified local name and value.

Syntax

public void WriteAttributeString (string localName, string value)

Parameters

value
The value of the attribute.
localName
The local name of the attribute.
value
The value of the attribute.

Exceptions

TypeReason
ArgumentException localName is null or string.Empty.
InvalidOperationExceptionThe XmlWriter.WriteState is not WriteState.Element.

Remarks

WriteAttributeString does the following:

  • If the attribute value includes double or single quotes, they are replaced with " and ' respectively.

  • If writing an xml:space attribute, the writer verifies the attribute value is valid. (Valid values are preserve or default.)

  • If writing an xml:lang attribute, the writer does not verify that the attribute value is valid according to the W3C XML 1.0 recommendation.

For the asynchronous version of this method, see XmlWriter.WriteAttributeStringAsync(string, string).

Requirements

Namespace: System.Xml
Assembly: System.Xml (in System.Xml.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0, 4.0.0.0