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

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

Source:

XmlTextWriter.cs

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

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

要寫入的字元數。

例外狀況

ArgumentNullException

buffer 為 null。

ArgumentOutOfRangeException

index 或 count 小於零。

-或-

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

InvalidOperationException

WriteState 已經關閉。

範例

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 配對字元，就會擲回例外狀況。