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

Definizione

Spazio dei nomi:
System.Xml
Assembly:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Origine:
XmlTextWriter.cs
Origine:
XmlTextWriter.cs
Origine:
XmlTextWriter.cs
Origine:
XmlTextWriter.cs
Origine:
XmlTextWriter.cs

Scrive testo 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 contenente 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 index è minore di count. La chiamata comporta la divisione dei caratteri di coppia surrogata o la scrittura di una coppia di surrogati non valida.

InvalidOperationException

è WriteState 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

Note

È consigliabile creare XmlWriter istanze usando il XmlWriter.Create metodo e la XmlWriterSettings classe per sfruttare le nuove funzionalità.

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 suddivide i caratteri della coppia di surrogati in più scritture di buffer. La specifica XML definisce gli intervalli validi per le coppie di surrogati.

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

Si applica a