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

Definición

Espacio de nombres:
System.Xml
Ensamblados:
netstandard.dll, System.Xml.ReaderWriter.dll
Ensamblado:
System.Xml.ReaderWriter.dll
Ensamblado:
System.Xml.dll
Ensamblado:
netstandard.dll
Source:
XmlTextWriter.cs
Source:
XmlTextWriter.cs
Source:
XmlTextWriter.cs
Source:
XmlTextWriter.cs
Source:
XmlTextWriter.cs

Escribe un búfer de texto a la 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 del búfer menos index es menor que count; la llamada da como resultado que los caracteres del par suplente se dividan o se escriba 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

Note

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 suplente que darían lugar a que los caracteres del par suplente se dividan en el búfer.

Se aplica a