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

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Origem:

XmlWriter.cs

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

ArgumentNullException

buffer é null.

ArgumentOutOfRangeException

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.

ArgumentException

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

InvalidOperationException

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.