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

Определение

Пространство имен:

System.Xml

Сборка:

System.Xml.ReaderWriter.dll

Исходный код:

XmlTextWriter.cs

Записывает содержимое текстового буфера.

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

-или-

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

InvalidOperationException

Объект WriteState закрыт.

Примеры

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 рекомендуется создавать XmlWriter экземпляры с помощью XmlWriter.Create метода и класса , XmlWriterSettings чтобы воспользоваться преимуществами новых функций.

Этот метод можно использовать для записи больших объемов текста в один буфер за раз.

Необходимо выполнить специальную обработку, чтобы метод WriteChars не разделял символы суррогатных пар между несколькими буферными записью. Спецификация XML определяет допустимые диапазоны для суррогатных пар.

Исключение возникает, если записываются символы суррогатной пары, что приведет к разделу символов суррогатной пары в буфере.