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

Riferimento

Definizione

Spazio dei nomi:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Il testo viene scritto in un buffer alla volta.

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)

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.

InvalidOperationException

La proprietà WriteState ha valore Closed.

Esempio

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

Commenti

Nota

A partire dalla .NET Framework 2.0, è consigliabile creare XmlWriter istanze usando il metodo e la XmlWriter.Create XmlWriterSettings classe per sfruttare le nuove funzionalità.

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

La gestione speciale deve essere eseguita per assicurarsi che il WriteChars metodo non suddivide i caratteri della coppia surrogata in più scritture del buffer. La specifica XML definisce gli intervalli validi per le coppie surrogate.

Viene generata un'eccezione se i caratteri di coppia surrogata vengono scritti che comportano la suddivisione dei caratteri della coppia surrogata nel buffer.

Si applica a

Condividi tramite