XmlTextWriter.WriteChars(Char[], Int32, Int32) メソッド

定義

一度に 1 つのバッファーにテキストを書き込みます。Writes text one buffer at a time.

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[]

書き込むテキストを格納している文字配列。Character array containing the text to write.

index
Int32

書き込むテキストの開始を示すバッファー内の位置。The position in the buffer indicating the start of the text to write.

count
Int32

書き込む文字数。The number of characters to write.

例外

buffernullです。buffer is null.

index または count が 0 未満です。index or count is less than zero.

- または --or- バッファー長から index を差し引いた値が count 未満です。この呼び出しにより、サロゲート ペア文字が分割されるか、無効なサロゲート ペアが書き込まれます。The buffer length minus index is less than count; the call results in surrogate pair characters being split or an invalid surrogate pair being written.

WriteState が閉じています。The WriteState is Closed.

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 インスタンスを作成することをお勧めします。Starting with the .NET Framework 2.0, we recommend that you create XmlWriter instances by using the XmlWriter.Create method and the XmlWriterSettings class to take advantage of new functionality.

このメソッドを使用して、一度に1つのバッファーに大量のテキストを書き込むことができます。This method can be used to write large amounts of text one buffer at a time.

WriteChars メソッドで複数のバッファー書き込みでサロゲートペア文字が分割されないようにするには、特別な処理を行う必要があります。Special handling must be done to ensure the WriteChars method does not split surrogate pair characters across multiple buffer writes. XML 仕様では、サロゲートペアの有効な範囲が定義されています。The XML specification defines the valid ranges for surrogate pairs.

サロゲートペアの文字が書き込まれ、サロゲートペアの文字がバッファーに分割されると、例外がスローされます。An exception is thrown if surrogate pair characters are written that would result in the surrogate pair characters being split in the buffer.

適用対象