Création de writers XML

Des instances de l'objet XmlWriter sont créées à l'aide de la méthode XmlWriter.Create statique.

Des instances de l'objet XmlWriter sont créées à l'aide de la méthode Create. La classe XmlWriterSettings permet de spécifier l'ensemble de fonctionnalités à activer sur le nouvel objet XmlWriter.

Important
Même si Microsoft .NET Framework intègre la classe XmlTextWriter, qui est une implémentation concrète de la classe XmlWriter, dans la version 2.0 de .NET Framework, il est recommandé de créer des instances de l'objet XmlWriter à l'aide de la méthode Create.

Les fonctionnalités sont activées ou désactivées à l'aide des propriétés de la classe XmlWriterSettings. Spécifiez les fonctionnalités du writer à prendre en charge en transmettant un objet XmlWriterSettings à la méthode Create. La méthode Create et la classe XmlWriterSettings offrent les avantages suivants :

• Vous pouvez spécifier les fonctionnalités que l'objet XmlWriter doit prendre en charge.

• L'objet XmlWriterSettings peut être réutilisé pour créer plusieurs objets de writer. L'objet XmlWriterSettings est copié et est mis en lecture seule pour chaque writer créé. Les modifications des paramètres d'une instance de l'objet XmlWriterSettings n'affectent pas les paramètres correspondants des writers existants. Par conséquent, vous pouvez utiliser les mêmes paramètres pour créer plusieurs writers avec la même fonctionnalité. Ou vous pouvez modifier les paramètres d'une instance de l'objet XmlWriterSettings et créer un nouveau writer avec différentes fonctionnalités.

• Vous pouvez ajouter des fonctionnalités à un writer existant. La méthode Create peut accepter un autre objet XmlWriter. L'objet XmlWriter sous-jacent ne doit pas être un writer créé à l'aide de la méthode Create statique. Par exemple, vous pouvez spécifier un writer défini par l'utilisateur ou un objet XmlTextWriter auquel vous souhaitez ajouter de nouvelles fonctionnalités.

• Bénéficiez de toutes les nouvelles fonctionnalités ajoutées à la classe XmlWriter dans cette version. Certaines fonctionnalités, comme une meilleure vérification de conformité et la conformité à la recommandation sur XML 1.0, ne sont disponibles que pour les objets XmlWriter créés à l'aide de la méthode Create statique.

Si un objet XmlWriterSettings n'est pas transmis à la méthode Create, les paramètres du writer par défaut sont utilisés. Le tableau suivant répertorie les paramètres par défaut de la classe XmlWriterSettings.

Propriété	Valeur initiale
CheckCharacters	true
CloseOutput	false
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	false
IndentChars	Deux espaces
NewLineChars	\r\n (retour chariot, retour à la ligne)
NewLineHandling	NewHandling.Replace
NewLineOnAttributes	false
OmitXmlDeclaration	false

Exemple

L'exemple suivant crée un objet XmlWriter qui génère un fichier XML.

Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.IndentChars = "    "
Using writer As XmlWriter = XmlWriter.Create("books.xml", settings)
  ' Write XML data.
  writer.WriteStartElement("book")
  writer.WriteElementString("price", "19.95")
  writer.WriteEndElement()
  writer.Flush()
End Using

XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.IndentChars = ("    ");
using (XmlWriter writer = XmlWriter.Create("books.xml", settings))
{
    // Write XML data.
    writer.WriteStartElement("book");
    writer.WriteElementString("price", "19.95");
    writer.WriteEndElement();
    writer.Flush();
}

Voir aussi

Autres ressources

Documents et données XML