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

정의

네임스페이스:

System.Xml

어셈블리:

System.Xml.ReaderWriter.dll

어셈블리:

System.Xml.dll

어셈블리:

netstandard.dll

한 번에 한 버퍼씩 텍스트를 씁니다.

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가 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부터 메서드와 XmlWriterSettings 클래스를 사용하여 XmlWriter.Create 새 기능을 활용하여 인스턴스를 만드는 XmlWriter 것이 좋습니다.

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

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

서로게이트 쌍 문자가 작성되어 서로게이트 쌍 문자가 버퍼에서 분할되는 경우 예외가 throw됩니다.