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

XmlTextWriter.Formatting propriété

 

Date de publication : novembre 2016

Indique la façon dont la sortie est mise en forme.

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

public Formatting Formatting { get; set; }

Valeur de propriété

Type: System.Xml.Formatting

Une des valeurs de Formatting. La valeur par défaut est Formatting.None (aucune mise en forme spéciale).

System_CAPS_noteRemarque

À compter de .NET Framework 2.0, nous vous recommandons de créer XmlWriter instances à l’aide de la XmlWriter.Create méthode et la XmlWriterSettings classe pour tirer parti des nouvelles fonctionnalités.

Si la Indented option est définie, les éléments enfants sont mis en retrait à l’aide de la Indentation et IndentChar Propriétés. Contenu uniquement de l’élément est mis en retrait. Le code c# suivant écrit des éléments HTML incluant un contenu mixte :

XmlTextWriter w = new XmlTextWriter(Console.Out); 
 w.Formatting = Formatting.Indented; 
 w.WriteStartElement("ol"); 
 w.WriteStartElement("li"); 
 w.WriteString("The big "); // This means "li" now has a mixed content model.
 w.WriteElementString("b", "E"); 
 w.WriteElementString("i", "lephant"); 
 w.WriteString(" walks slowly."); 
 w.WriteEndElement(); 
 w.WriteEndElement();

Le code ci-dessus génère la sortie suivante :

<ol> 
  <li>The big <b>E</b><i>lephant</i> walks slowly.</li> 
</ol>

Lorsqu’il est affiché en mode HTML aucun espace blanc n’apparaît entre les éléments en gras et italique. En fait, dans cet exemple, si la mise en retrait était ajoutée entre ces éléments le mot « Éléphant » serait coupé de manière incorrecte.

System_CAPS_noteRemarque

Écrire n’importe quel texte, sauf String.Empty place cet élément en mode de contenu mixte. Éléments enfants n’héritent pas de cet état de mode « mixte ». Un élément enfant d’un élément « mixte » est mise en retrait, sauf s’il est également contenu « mixte ». Contenu de l’élément (http://www.w3.org/TR/1998/REC-xml-19980210#sec-element-content) et le contenu mixte (http://www.w3.org/TR/1998/REC-xml-19980210#sec-mixed-content) sont définis selon les définitions XML 1.0 de ces termes.

L’exemple suivant écrit un fragment XML.

using System;
using System.IO;
using System.Xml;

public class Sample
{

  public static void Main()
  {
     //Create a writer to write XML to the console.
     XmlTextWriter writer = null;
     writer = new XmlTextWriter (Console.Out);

     //Use indentation for readability.
     writer.Formatting = Formatting.Indented;
     writer.Indentation = 4;

     //Write an element (this one is the root).
     writer.WriteStartElement("book");

     //Write the title element.
     writer.WriteStartElement("title");
     writer.WriteString("Pride And Prejudice");
     writer.WriteEndElement();

     //Write the close tag for the root element.
     writer.WriteEndElement();

     //Write the XML to file and close the writer.
     writer.Close();  

  }

}

.NET Framework
Disponible depuis 1.1
Retour au début
Afficher: