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

Référence

Définition

Espace de noms:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Source:: XmlTextWriter.cs

Source:: XmlTextWriter.cs

Source:: XmlTextWriter.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Écrit du texte mémoire tampon par mémoire tampon.

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)

Paramètres

buffer: Char[]

Tableau de caractères contenant le texte à écrire.

index: Int32

Emplacement dans la mémoire tampon indiquant le début du texte à écrire.

count: Int32

Nombre de caractères à écrire.

Exceptions

ArgumentNullException

buffer a la valeur null.

ArgumentOutOfRangeException

index ou count est inférieur à zéro.

- ou -

La longueur de la mémoire tampon moins index est inférieure à count ; par conséquent, l'appel entraîne une séparation des caractères de paire de substitution ou l'écriture d'une paire de substitution non valide.

InvalidOperationException

WriteState est fermé.

Exemples

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

Remarques

Notes

À compter de .NET Framework 2.0, nous vous recommandons de créer XmlWriter des instances à l’aide de la XmlWriter.Create méthode et de la XmlWriterSettings classe pour tirer parti des nouvelles fonctionnalités.

Cette méthode peut être utilisée pour écrire de grandes quantités de texte, une mémoire tampon à la fois.

Une gestion spéciale doit être effectuée pour garantir que la WriteChars méthode ne fractionne pas les caractères de paire de substitution entre plusieurs écritures de mémoire tampon. La spécification XML définit les plages valides pour les paires de substitution.

Une exception est levée si des caractères de paire de substitution sont écrits, ce qui entraînerait le fractionnement des caractères de paire de substitution dans la mémoire tampon.

S’applique à