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

定義

名前空間:

System.Xml

アセンブリ:

System.Xml.ReaderWriter.dll

アセンブリ:

System.Xml.dll

アセンブリ:

netstandard.dll

一度に 1 つのバッファーにテキストを書き込みます。

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 が 0 未満です。

• または - バッファー長から index を差し引いた値が count 未満です。この呼び出しにより、サロゲート ペア文字が分割されるか、無効なサロゲート ペアが書き込まれます。

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 以降では、新しい機能を利用するために、メソッドとXmlWriterSettingsクラスをXmlWriter.Create使用してインスタンスを作成XmlWriterすることをお勧めします。

このメソッドを使用すると、一度に 1 つのバッファーに大量のテキストを書き込むことができます。

メソッドがサロゲート ペア文字を複数の WriteChars バッファー書き込みに分割しないように、特別な処理を行う必要があります。 XML 仕様では、サロゲート ペアの有効な範囲が定義されています。

サロゲート ペア文字が書き込まれると、サロゲート ペア文字がバッファーに分割される場合、例外がスローされます。