Partager via


Nouvelles fonctionnalités de la classe XmlWriter

Microsoft .NET Framework version 2.0 comprend de nombreuses modifications de la conception et des fonctionnalités apportées à la classe XmlWriter.

Création d'objets XmlWriter

La méthode Create représente le mécanisme préféré d'obtention d'objets XmlWriter. La méthode Create utilise la classe XmlWriterSettings pour spécifier les fonctions devant être prises en charge par l'instance de l'objet XmlWriter.

Pour plus d'informations, voir Création de writers XML.

Conformité des données

Des objets XmlWriter créés par la méthode Create sont, par défaut, plus conformes que l'implémentation XmlTextWriter. L'utilisation de la méthode Create et de la classe XmlWriterSettings offre deux fonctions supplémentaires de vérification de la conformité.

Vérification des caractères

La propriété XmlWriterSettings.CheckCharacters configure l'objet XmlWriter pour vérifier les caractères contenus dans le flux de données XML afin de s'assurer que tous les caractères sont compris dans la plage de caractères XML légaux. La vérification des caractères inclut la recherche de caractères illégaux dans les nœuds de texte et les noms XML ainsi que le contrôle de validité des noms XML (par exemple, un nom XML ne peut pas commencer par un chiffre). Si les données XML ne figurent pas dans la plage de caractères XML légaux, un objet XmlException est levé.

Vérification de la conformité

La propriété XmlWriterSettings.ConformanceLevel configure l'objet XmlWriter pour vérifier et garantir que le flux en cours de lecture respecte un certain ensemble de règles. En fonction du niveau de conformité spécifié, les données XML peuvent être vérifiées pour voir si elles sont conformes aux règles d'un document ou d'un fragment de document XML 1.0 correctement construit. Si les données ne sont pas conformes, un objet XmlException est levé.

Pour plus d'informations, voir Conformité des données et la classe XmlWriter.

Prise en charge de type

La classe XmlWriter permet d'écrire des valeurs comme des valeurs CLR (Common Language Runtime) de type simple.

Vous pouvez utiliser la méthode WriteValue pour transmettre des valeurs à l'aide de types de systèmes au lieu de chaînes. Cela vous permet d'écrire des valeurs directement sans devoir effectuer manuellement des conversions de valeurs.

Pour plus d'informations, voir Écriture de données typées.

Voir aussi

Autres ressources

Utilisation de XmlWriter

Documents et données XML