Partager via

Création de writers XML

  • Article

Mise à jour : November 2007

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.

Remarque importante :

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