XmlWriter.WriteChars(Char[], Int32, Int32) Méthode
Définition
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.
En cas de substitution dans une classe dérivée, écrit du texte mémoire tampon par mémoire tampon.
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 -> unitPublic MustOverride 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
buffer a la valeur null.
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.
La valeur de paramètre buffer n'est pas valide.
Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».
Exemples
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();
}
Remarques
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.
Pour obtenir la version asynchrone de cette méthode, consultez WriteCharsAsync.
