XmlWriter.WriteChars(Char[], Int32, Int32) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
파생 클래스에서 재정의되는 경우 한 번에 하나의 버퍼 텍스트를 씁니다.
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 -> unitPublic MustOverride Sub WriteChars (buffer As Char(), index As Integer, count As Integer)매개 변수
- buffer
- Char[]
쓸 텍스트가 포함된 문자 배열입니다.
- index
- Int32
쓸 텍스트의 시작을 나타내는 버퍼의 위치입니다.
- count
- Int32
쓸 문자 수입니다.
예외
buffer은 null입니다.
index 또는 count 0보다 작습니다.
-또는-
버퍼 길이가 빼기 index 보다 count작습니다. 호출하면 서로게이트 쌍 문자가 분할되거나 잘못된 서로게이트 쌍이 작성됩니다.
buffer 매개 변수 값이 잘못되었습니다.
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.
