XmlWriter.WriteChars(Char[], Int32, Int32) Metodo

Definizione

Spazio dei nomi:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Quando ne viene eseguito l'override in una classe derivata, scrive il testo in un buffer alla volta.

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)

Parametri

buffer

Char[]

Matrice di caratteri che contiene il testo da scrivere.

index

Int32

Posizione nel buffer che indica l'inizio del testo da scrivere.

count

Int32

Numero di caratteri da scrivere.

Eccezioni

ArgumentNullException

buffer è null.

ArgumentOutOfRangeException

index o count è minore di zero.

-oppure- La lunghezza del buffer meno il parametro index è inferiore al parametro count; il risultato della chiamata consiste nella separazione dei caratteri della coppia di surrogati o nella scrittura di una coppia di surrogati non valida.

ArgumentException

Il valore del parametro buffer non è valido.

InvalidOperationException

È stato chiamato un metodo della classe XmlWriter prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".

Esempio

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

Commenti

Questo metodo può essere usato per scrivere grandi quantità di testo un buffer alla volta.

È necessario eseguire una gestione speciale per garantire che il WriteChars metodo non divida i caratteri della coppia surrogata tra più scritture di buffer. La specifica XML definisce gli intervalli validi per le coppie di surrogati.

Per la versione asincrona di questo metodo, vedere WriteCharsAsync.