XmlWriter.WriteName(String) 方法

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

在衍生類別中覆寫時，寫出指定的名稱，確保它是根據 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 不是有效的 XML 名稱，或者 name 是 null 或 String.Empty。

在先前的非同步作業完成前呼叫了 XmlWriter 方法。在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

如果 Namespaces 設定為 true ， WriteName 也會根據 XML 建議中的 W3C 命名空間檢查名稱是否也有效。

如需這個方法的非同步版本，請參閱 WriteNameAsync 。