XmlWriter.WriteChars(Char[], Int32, Int32) XmlWriter.WriteChars(Char[], Int32, Int32) XmlWriter.WriteChars(Char[], Int32, Int32) XmlWriter.WriteChars(Char[], Int32, Int32) Method

定義

派生クラスでオーバーライドされると、一度に 1 つのバッファーにテキストを書き込みます。When overridden in a derived class, writes text one buffer at a time.

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

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

index
Int32 Int32 Int32 Int32

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

count
Int32 Int32 Int32 Int32

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

例外

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.

buffer パラメーター値が有効ではありません。The buffer parameter value is not valid.

先行の非同期操作が完了する前に、XmlWriter メソッドが呼び出されました。An XmlWriter method was called before a previous asynchronous operation finished. この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

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();
}

注釈

このメソッドは、一度に大量の 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.

このメソッドの非同期バージョンを参照してください。WriteCharsAsyncします。For the asynchronous version of this method, see WriteCharsAsync.

適用対象