XmlWriter.WriteChars(Char[], Int32, Int32) 方法

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

來源:

XmlWriter.cs

在衍生類別中覆寫時，一次將文字寫入一個緩衝區。

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

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

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

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

參數

buffer

Char[]

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

index

Int32

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

count

Int32

要寫入的字元數。

例外狀況

ArgumentNullException

buffer 為 null。

ArgumentOutOfRangeException

index 或 count 小於零。

-或-

緩衝區長度減去 index 小於 count；這個呼叫會導致 Surrogate 字組字元被分隔或寫入無效的 Surrogate 字組。

ArgumentException

buffer 參數值無效。

InvalidOperationException

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

範例

using (XmlWriter writer = XmlWriter.Create("WriteChars.xml"))
{
    writer.WriteStartDocument();

    char[] ch = new char[4];
    ch[0] = 't';
    ch[1] = 'e';
    ch[2] = 'x';
    ch[3] = 't';

    writer.WriteStartElement("WriteCharacters");
    writer.WriteChars(ch, 0, ch.Length);
    writer.WriteEndElement();
    writer.WriteEndDocument();
}

備註

這個方法可用來一次寫入大量文字一個緩衝區。

必須進行特殊處理， WriteChars 以確保方法不會將 Surrogate 字組字元分割到多個緩衝區寫入。 XML 規格會定義 Surrogate 字組的有效範圍。

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