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
- String
要寫入的名稱。
例外狀況
name
不是有效的 XML 名稱,或者 name
是 null
或 String.Empty
。
在先前的非同步作業完成前呼叫了 XmlWriter 方法。 在此情況下,會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。
備註
如果 Namespaces 設定為 true
, WriteName
也會根據 XML 建議中的 W3C 命名空間檢查名稱是否也有效。
如需這個方法的非同步版本,請參閱 WriteNameAsync 。