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 -> unitabstract member WriteName : string -> unitPublic 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 。
| 產品 | 版本 |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
