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

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

Source:

XmlTextWriter.cs

Escribe texto en un búfer 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 -> unit

Public Overrides Sub WriteChars (buffer As Char(), index As Integer, count As Integer)

Parámetros

buffer

Char[]

Matriz de caracteres que contiene el texto que se va a escribir.

index

Int32

Posición en el búfer que indica el inicio del texto que se va a escribir.

count

Int32

Número de caracteres que se van a escribir.

Excepciones

ArgumentNullException

buffer es null.

ArgumentOutOfRangeException

index o count es menor que cero.

o bien

La longitud de búfer menos index es menor que count; la llamada tiene como resultado la división de los caracteres de par suplente o la escritura de un par suplente no válido.

InvalidOperationException

WriteState está cerrado.

Ejemplos

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

Comentarios

Nota:

A partir de .NET Framework 2.0, se recomienda crear XmlWriter instancias mediante el XmlWriter.Create método y la XmlWriterSettings clase para aprovechar las nuevas funcionalidades.

Este método se puede usar para escribir grandes cantidades de texto de un búfer a la vez.

Se debe realizar un control especial para asegurarse de que el WriteChars método no divide los caracteres de par suplente en varias escrituras de búfer. La especificación XML define los intervalos válidos para los pares suplentes.

Se produce una excepción si se escriben caracteres de par suplentes que darían lugar a que los caracteres del par suplente se dividan en el búfer.