XmlWriter.WriteChars(Char[], Int32, Int32) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Quando é sobreposto numa classe derivada, escreve texto um buffer de cada 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 -> unitPublic MustOverride Sub WriteChars (buffer As Char(), index As Integer, count As Integer)Parâmetros
- buffer
- Char[]
Array de caracteres contendo o texto a escrever.
- index
- Int32
A posição no buffer indica o início do texto a escrever.
- count
- Int32
O número de caracteres a escrever.
Exceções
buffer é null.
index ou count é inferior a zero.
-ou-
O comprimento do buffer menos index é menor que count; a chamada resulta na divisão dos caracteres do par substituto ou na escrita de um par substituto inválido.
O buffer valor do parâmetro não é válido.
Um XmlWriter método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."
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();
}
Observações
Este método pode ser usado para escrever grandes quantidades de texto, um buffer de cada vez.
Deve ser feito um tratamento especial para garantir que o WriteChars método não divide caracteres de pares substitutos em múltiplas escritas de buffer. A especificação XML define os intervalos válidos para pares substitutos.
Para a versão assíncrona deste método, veja WriteCharsAsync.
