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

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

Ensamblado:

System.Xml.dll

Ensamblado:

netstandard.dll

Cuando se invalida en una clase derivada, escribe texto en un búfer cada vez.

C#

public abstract void WriteChars (char[] buffer, int index, int count);

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.

ArgumentException

El valor del parámetro buffer no es válido.

InvalidOperationException

Se llamó un método XmlWriter antes de que se termine una operación asincrónica anterior. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.

Ejemplos

C#

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

Comentarios

Este método se puede usar para escribir grandes cantidades de texto de un búfer cada 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.

Para obtener la versión asincrónica de este método, vea WriteCharsAsync.

Se aplica a