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 меньше нуля.

-или- Длина буфера за вычетом index меньше count; вызов приводит к разделению пар символов-заместителей или к записи недопустимой пары символов-заместителей.

ArgumentException

Значение параметра buffer является недопустимым.

InvalidOperationException

Метод XmlWriter вызван перед завершением предыдущей асинхронной операции. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".

Примеры

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.