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

Definizione

Il testo viene scritto in un buffer alla volta.Writes text one buffer at a time.

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.Character array containing the text to write.

index
Int32 Int32 Int32 Int32

Posizione nel buffer che indica l'inizio del testo da scrivere.The position in the buffer indicating the start of the text to write.

count
Int32 Int32 Int32 Int32

Numero di caratteri da scrivere.The number of characters to write.

Eccezioni

index o count è minore di zero.index or count is less than zero.

-oppure--or- 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.The buffer length minus index is less than count; the call results in surrogate pair characters being split or an invalid surrogate pair being written.

Esempi

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 da .NET Framework 2,0, è consigliabile creare XmlWriter istanze usando il XmlWriter.Create metodo e la XmlWriterSettings classe per sfruttare le nuove funzionalità.Starting with the .NET Framework 2.0, we recommend that you create XmlWriter instances by using the XmlWriter.Create method and the XmlWriterSettings class to take advantage of new functionality.

Questo metodo può essere utilizzato per scrivere grandi quantità di testo in un buffer alla volta.This method can be used to write large amounts of text one buffer at a time.

È necessario eseguire una gestione speciale per assicurarsi WriteChars che il metodo non suddivida i caratteri della coppia di surrogati tra più scritture del buffer.Special handling must be done to ensure the WriteChars method does not split surrogate pair characters across multiple buffer writes. La specifica XML definisce gli intervalli validi per le coppie di surrogati.The XML specification defines the valid ranges for surrogate pairs.

Viene generata un'eccezione se vengono scritti caratteri della coppia di surrogati che comporteranno la suddivisione dei caratteri della coppia di surrogati nel buffer.An exception is thrown if surrogate pair characters are written that would result in the surrogate pair characters being split in the buffer.

Si applica a