共用方式為


XmlWriter.WriteStartAttribute 方法

定義

在衍生類別中覆寫時,寫入屬性的開頭。

多載

WriteStartAttribute(String, String, String)

在衍生類別中覆寫時,寫入具有指定的前置詞、區域名稱和命名空間 URI 之屬性的開頭。

WriteStartAttribute(String)

寫入具有指定之區域名稱的屬性開頭。

WriteStartAttribute(String, String)

寫入具有指定之區域名稱和命名空間 URI 之屬性的開頭。

備註

如需這個方法的非同步版本,請參閱 WriteStartAttributeAsync

WriteStartAttribute(String, String, String)

來源:
XmlWriter.cs
來源:
XmlWriter.cs
來源:
XmlWriter.cs

在衍生類別中覆寫時,寫入具有指定的前置詞、區域名稱和命名空間 URI 之屬性的開頭。

public:
 abstract void WriteStartAttribute(System::String ^ prefix, System::String ^ localName, System::String ^ ns);
public abstract void WriteStartAttribute (string prefix, string localName, string ns);
public abstract void WriteStartAttribute (string? prefix, string localName, string? ns);
abstract member WriteStartAttribute : string * string * string -> unit
Public MustOverride Sub WriteStartAttribute (prefix As String, localName As String, ns As String)

參數

prefix
String

屬性的命名空間前置詞。

localName
String

屬性的本機名稱。

ns
String

屬性的命名空間 URI。

例外狀況

緩衝區中有一個字元,其為有效的 XML 字元,但對輸出編碼而言無效。 比方說如果輸出的編碼方式為 ASCII,您應該在項目與屬性名稱中只使用範圍從 0 至 127 的字元。 無效的字元可能是在這個方法的引數中,或在先前已寫入至緩衝區的方法的引數中。 字元實體參考會盡可能逸出這類字元 (比方說在文字節點或屬性值中)。 不過,在項目與屬性名稱、註解、處理指示或 CDATA 區段中不允許字元實體參考。

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

備註

這個方法可讓您使用多個 Write 方法撰寫值。

如需這個方法的非同步版本,請參閱 WriteStartAttributeAsync

適用於

WriteStartAttribute(String)

來源:
XmlWriter.cs
來源:
XmlWriter.cs
來源:
XmlWriter.cs

寫入具有指定之區域名稱的屬性開頭。

public:
 void WriteStartAttribute(System::String ^ localName);
public void WriteStartAttribute (string localName);
member this.WriteStartAttribute : string -> unit
Public Sub WriteStartAttribute (localName As String)

參數

localName
String

屬性的本機名稱。

例外狀況

寫入器已關閉。

-或-

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

緩衝區中有一個字元,其為有效的 XML 字元,但對輸出編碼而言無效。 比方說如果輸出的編碼方式為 ASCII,您應該在項目與屬性名稱中只使用範圍從 0 至 127 的字元。 無效的字元可能是在這個方法的引數中,或在先前已寫入至緩衝區的方法的引數中。 字元實體參考會盡可能逸出這類字元 (比方說在文字節點或屬性值中)。 不過,在項目與屬性名稱、註解、處理指示或 CDATA 區段中不允許字元實體參考。

備註

這個方法可讓您使用多個 Write 方法撰寫值。

如需這個方法的非同步版本,請參閱 WriteStartAttributeAsync

適用於

WriteStartAttribute(String, String)

來源:
XmlWriter.cs
來源:
XmlWriter.cs
來源:
XmlWriter.cs

寫入具有指定之區域名稱和命名空間 URI 之屬性的開頭。

public:
 void WriteStartAttribute(System::String ^ localName, System::String ^ ns);
public void WriteStartAttribute (string localName, string ns);
public void WriteStartAttribute (string localName, string? ns);
member this.WriteStartAttribute : string * string -> unit
Public Sub WriteStartAttribute (localName As String, ns As String)

參數

localName
String

屬性的本機名稱。

ns
String

屬性的命名空間 URI。

例外狀況

緩衝區中有一個字元,其為有效的 XML 字元,但對輸出編碼而言無效。 比方說如果輸出的編碼方式為 ASCII,您應該在項目與屬性名稱中只使用範圍從 0 至 127 的字元。 無效的字元可能是在這個方法的引數中,或在先前已寫入至緩衝區的方法的引數中。 字元實體參考會盡可能逸出這類字元 (比方說在文字節點或屬性值中)。 不過,在項目與屬性名稱、註解、處理指示或 CDATA 區段中不允許字元實體參考。

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

範例

如需使用此方法的範例,請參閱 XmlTextWriter.WriteStartAttribute

備註

這是更進階的 版本 WriteAttributeString ,可讓您使用多個寫入方法撰寫屬性值,例如 WriteStringWriteQualifiedName 等等。

如需這個方法的非同步版本,請參閱 WriteStartAttributeAsync

另請參閱

適用於