XmlWriter.WriteChars(Char[], Int32, Int32) 메서드

정의

네임스페이스:

System.Xml

어셈블리:

System.Xml.ReaderWriter.dll

어셈블리:

System.Xml.dll

어셈블리:

netstandard.dll

파생 클래스에서 재정의되면 한 번에 한 버퍼씩 텍스트를 작성합니다.

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

쓸 텍스트가 포함된 문자 배열입니다.

index

Int32

쓸 텍스트의 시작을 나타내는 버퍼 내의 위치입니다.

count

Int32

쓸 문자 수입니다.

예외

ArgumentNullException

buffer이(가) null인 경우

ArgumentOutOfRangeException

index 또는 count가 0보다 작습니다.

또는 버퍼 길이에서 index를 뺀 값이 count보다 작고, 호출한 결과 서로게이트 쌍 문자가 분할되거나 잘못된 서로게이트 쌍이 작성되는 경우

ArgumentException

buffer 매개 변수 값이 잘못된 경우

InvalidOperationException

이전 비동기 작업이 완료되기 전에 XmlWriter 메서드가 호출되었습니다. 이 경우 “비동기 작업이 이미 진행 중입니다.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.

예제

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

설명

이 메서드는 한 번에 하나의 버퍼에 많은 양의 텍스트를 쓰는 데 사용할 수 있습니다.

메서드가 서로게이트 쌍 문자를 여러 버퍼 쓰기 간에 분할하지 않도록 WriteChars 특수 처리를 수행해야 합니다. XML 사양은 서로게이트 쌍의 유효한 범위를 정의합니다.

이 메서드의 비동기 버전은 다음을 참조하세요 WriteCharsAsync.