XmlTextWriter.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.
Escreve texto um buffer de cada 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 -> unitPublic Overrides 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.
Está WriteState Fechado.
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();
}
Observações
Note
Recomendamos que crie instâncias XmlWriter usando o método XmlWriter.Create e a classe XmlWriterSettings para aproveitar a nova funcionalidade.
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.
É feita uma exceção se forem escritos caracteres de pares substitutos que resultariam na divisão dos caracteres de pares substitutos no buffer.
