XmlWriter.WriteName(String) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
public:
virtual void WriteName(System::String ^ name);
public:
abstract void WriteName(System::String ^ name);
public virtual void WriteName (string name);
public abstract void WriteName (string name);
abstract member WriteName : string -> unit
override this.WriteName : string -> unit
abstract member WriteName : string -> unit
Public Overridable Sub WriteName (name As String)
Public MustOverride Sub WriteName (name As String)
Parameters
- name
- String
The name to write.
Exceptions
name
is not a valid XML name; or name
is either null
or String.Empty
.
An XmlWriter method was called before a previous asynchronous operation finished. In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."
Remarks
If 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 WriteNameAsync.