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 -> unitPublic 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();
}
Комментарии
Note
Рекомендуется создавать XmlWriter экземпляры с помощью XmlWriter.Create метода и XmlWriterSettings класса, чтобы воспользоваться преимуществами новых функций.
Этот метод можно использовать для записи больших объемов текста в один буфер за раз.
Необходимо выполнить специальную обработку, чтобы WriteChars метод не разделял символы суррогатной пары между несколькими буферными записью. Спецификация XML определяет допустимые диапазоны для суррогатных пар.
Исключение возникает, если суррогатные символы пары записываются, что приведет к разделию суррогатных пар в буфере.
