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

Referencia

Definición

Espacio de nombres:: System.Xml

Ensamblado:: System.Xml.ReaderWriter.dll

Ensamblado:: System.Xml.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Cuando se invalida en una clase derivada, escribe texto en un búfer 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 -> unit

Public MustOverride 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.

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

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

Compartir vía