共用方式為


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

定義

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

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

要寫入的字元數。

例外狀況

buffernull

indexcount 小於零。

-或-

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

buffer 參數值無效。

在先前的非同步作業完成前呼叫了 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

適用於