XmlWriter.WriteRaw 方法

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

組件:

System.Xml.dll

組件:

netstandard.dll

在衍生類別中覆寫時，手動寫入未經處理的標記。

多載

WriteRaw(String)	在衍生類別中覆寫時，從字串手動寫入未經處理的標記 (Raw Markup)。
WriteRaw(Char[], Int32, Int32)	在衍生類別中覆寫時，從字元緩衝區手動寫入未經處理的標記。

備註

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

WriteRaw(String)

在衍生類別中覆寫時，從字串手動寫入未經處理的標記 (Raw Markup)。

public:
 abstract void WriteRaw(System::String ^ data);

public abstract void WriteRaw (string data);

abstract member WriteRaw : string -> unit

Public MustOverride Sub WriteRaw (data As String)

參數

data

String

包含要寫入之文字的字串。

例外狀況

ArgumentException

data 為 null 或 String.Empty。

InvalidOperationException

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

範例

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

備註

這個方法不會逸出特殊字元。

重要

XmlWriter不會驗證傳遞至 WriteRaw 方法的資料。 您不應該將任意資料傳遞至這個方法。

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

WriteRaw(Char[], Int32, Int32)

在衍生類別中覆寫時，從字元緩衝區手動寫入未經處理的標記。

public:
 abstract void WriteRaw(cli::array <char> ^ buffer, int index, int count);

public abstract void WriteRaw (char[] buffer, int index, int count);

abstract member WriteRaw : char[] * int * int -> unit

Public MustOverride Sub WriteRaw (buffer As Char(), index As Integer, count As Integer)

參數

buffer

Char[]

包含要寫入之文字的字元陣列。

index

Int32

緩衝區中指示要寫入的文字開頭的位置。

count

Int32

要寫入的字元數。

例外狀況

ArgumentNullException

buffer 為 null。

ArgumentOutOfRangeException

index 或 count 小於零。

-或- 緩衝區長度減去 index 會小於 count。

InvalidOperationException

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

備註

這個方法不會逸出特殊字元。

重要

XmlWriter不會驗證傳遞至 WriteRaw 方法的資料。 您不應該將任意資料傳遞至這個方法。

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