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

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