System.Xml.XmlWriter.WriteName Method

When overridden in a derived class, writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation (http://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

Syntax

public virtual void WriteName (string name)

Parameters

name
The name to write.

Exceptions

TypeReason
ArgumentException name is null or string.Empty; or name is not a valid XML Name.
InvalidOperationExceptionThe XmlWriter.WriteState is WriteState.Closed.

Remarks

If XmlTextWriter.Namespaces is set to true, WriteName also checks that the name is also valid according to the W3C Namespaces in XML recommendation.

For the asynchronous version of this method, see XmlWriter.WriteNameAsync(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