Поделиться через


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

Определение

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

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

Количество символов для записи.

Исключения

buffer имеет значение null.

Значение параметра index или count меньше нуля.

-или-

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

Объект 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 определяет допустимые диапазоны для суррогатных пар.

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

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