Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

XmlTextWriter.WriteChars, méthode

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

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

public override 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.

ExceptionCondition
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é.

RemarqueRemarque

Dans la version .NET Framework 2.0, la méthode recommandée consiste à créer des instances de XmlWriter à l'aide de la méthode XmlWriter.Create et de la classe XmlWriterSettings. Cela vous permet de tirer pleinement parti de toutes les nouvelles fonctionnalités incluses dans cette version. Pour plus d'informations, consultez Création de writers XML.

Cette méthode permet d'écrire de grandes quantités de texte, mémoire tampon par mémoire tampon.

Une gestion particulière doit être effectuée pour vérifier que la méthode WriteChars ne sépare pas les caractères de paire de substitution lors de plusieurs écritures dans la 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 d'une manière qui entraînerait leur séparation dans la mémoire tampon.


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


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft