XmlWriter.WriteName(String) 方法

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

程序集:

System.Xml.dll

程序集:

netstandard.dll

当在派生类中被重写时，写出指定的名称，确保它是符合 W3C XML 1.0 建议 (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)

参数

name

String

要写入的名称。

例外

ArgumentException

name 不是有效的 XML 名称，或者 name 为 null 或 String.Empty。

InvalidOperationException

在上一次异步操作完成之前调用了 XmlWriter 方法。 在此情况下，会引发 InvalidOperationException 并显示消息“异步操作已在进行中。”

注解

如果 Namespaces 设置为 true， WriteName 还根据 XML 建议中的 W3C 命名空间检查名称是否也有效。

有关此方法的异步版本，请参阅 WriteNameAsync。