Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

XmlWriter.WriteChars méthode (Char[], Int32, Int32)

 

Date de publication : novembre 2016

En cas de substitution dans une classe dérivée, écrit du texte mémoire tampon par mémoire tampon.

Espace de noms:   System.Xml
Assembly:  System.Xml (dans System.Xml.dll)

public abstract void WriteChars(
	char[] buffer,
	int index,
	int count
)

Paramètres

buffer
Type: System.Char[]

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

index
Type: System.Int32

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

count
Type: System.Int32

Nombre de caractères à écrire.

Exception Condition
ArgumentNullException

buffer a la valeur null.

ArgumentOutOfRangeException

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

ou

Longueur de la mémoire tampon moins index est inférieure à count; les résultats de l’appel de caractères de paire de substitution soit fractionnée ou écrits par une paire de substitution non valide.

ArgumentException

Le buffer la valeur du paramètre n’est pas valide.

InvalidOperationException

Un XmlWriter méthode a été appelée avant la fin d'une opération asynchrone précédente. Dans ce cas, InvalidOperationException est levée avec le message « une opération asynchrone est déjà en cours. »

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

Gestion particulière doit être effectuée pour garantir la WriteChars méthode ne fractionne pas les caractères de paire de substitution sur 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 la page WriteCharsAsync.

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

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: