Partilhar via


XmlWriter.WriteChars(Char[], Int32, Int32) Método

Definição

Quando substituído em uma classe derivada, grava texto um buffer por vez.

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)

Parâmetros

buffer
Char[]

Uma matriz de caracteres que contém o texto a ser gravado.

index
Int32

A posição do buffer que indica o início do texto a ser gravado.

count
Int32

O número de caracteres a serem gravados.

Exceções

buffer é null.

index ou count é menor que zero.

- ou -

O tamanho do buffer menos index é menor que count; a chamada resulta em caracteres do par alternativo sendo divididos ou na gravação de um par alternativo inválido.

O valor do parâmetro buffer não é válido.

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

Exemplos

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();
}

Comentários

Esse método pode ser usado para gravar grandes quantidades de texto um buffer por vez.

A manipulação especial deve ser feita para garantir que o WriteChars método não divida caracteres de par alternativos em várias gravações de buffer. A especificação XML define os intervalos válidos para pares alternativos.

Para obter a versão assíncrona desse método, consulte WriteCharsAsync.

Aplica-se a