XmlWriter.WriteStartAttribute 方法

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

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

多載

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

備註

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

WriteStartAttribute(String, String, String)

來源:

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);

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。

例外狀況

EncoderFallbackException

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

InvalidOperationException

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

備註

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

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

WriteStartAttribute(String)

來源:

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

屬性的本機名稱。

例外狀況

InvalidOperationException

寫入器已關閉。

-或-

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

EncoderFallbackException

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

備註

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

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

WriteStartAttribute(String, String)

來源:

XmlWriter.cs

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

public:
 void WriteStartAttribute(System::String ^ localName, System::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。

例外狀況

EncoderFallbackException

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

InvalidOperationException

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

範例

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

備註

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

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

另請參閱

• WriteEndAttribute()