Compartilhar via


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

Definição

Grava texto um buffer por vez.

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)

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.

Exemplos

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

Comentários

Observação

A partir do .NET Framework 2.0, recomendamos que você crie XmlWriter instâncias usando o XmlWriter.Create método e a XmlWriterSettings classe para aproveitar a nova funcionalidade.

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

O tratamento especial deve ser feito 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 substitutos.

Uma exceção será gerada se caracteres de par alternativos forem gravados, o que resultaria na divisão dos caracteres do par alternativo no buffer.

Aplica-se a