XmlWriter.WriteChars(Char[], Int32, Int32) Метод

Определение

Пространство имен:
System.Xml
Сборки:
System.Xml.dll, System.Xml.ReaderWriter.dll
Сборки:
netstandard.dll, System.Xml.ReaderWriter.dll
Сборка:
System.Xml.ReaderWriter.dll
Сборка:
System.Xml.dll
Сборка:
netstandard.dll
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs

При переопределении в производном классе записывает текст в один буфер за раз.

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.

Применяется к