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

정의

파생 클래스에서 재정의되면 한 번에 한 버퍼씩 텍스트를 작성합니다.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이 throw됩니다.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();
}

설명

이 메서드 한 번에 많은 양의 텍스트 하나의 버퍼를 쓰는 데 사용할 수 있습니다.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.

적용 대상