共用方式為


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

定義

一次將文字寫入一個緩衝區。

public:
 override void WriteChars(cli::array <char> ^ buffer, int index, int count);
public override void WriteChars (char[] buffer, int index, int count);
override this.WriteChars : char[] * int * int -> unit
Public Overrides Sub WriteChars (buffer As Char(), index As Integer, count As Integer)

參數

buffer
Char[]

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

index
Int32

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

count
Int32

要寫入的字元數。

例外狀況

buffernull

indexcount 小於零。

-或-

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

範例

using (XmlTextWriter writer = new XmlTextWriter(Console.Out))
{
    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();
}

備註

注意

從 .NET Framework 2.0 開始,建議您使用 XmlWriter.Create 方法和 XmlWriterSettings 類別來建立 XmlWriter 實例,以利用新功能。

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

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

如果寫入 Surrogate 配對字元會導致在緩衝區中分割 Surrogate 配對字元,就會擲回例外狀況。

適用於