XmlWriterSettings.Indent Propriété

Définition

Espace de noms:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Obtient ou définit une valeur indiquant si les éléments doivent être mis en retrait.

public:
 property bool Indent { bool get(); void set(bool value); };

public bool Indent { get; set; }

member this.Indent : bool with get, set

Public Property Indent As Boolean

Valeur de propriété

Boolean

true pour écrire des éléments individuels sur de nouvelles lignes et les mettre en retrait ; sinon, false. La valeur par défaut est false.

Exemples

L’exemple suivant crée un XmlWriter objet qui utilise le caractère TAB pour la mise en retrait.

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

public class Sample {

  public static void Main() {

    XmlWriter writer = null;

    try {

       // Create an XmlWriterSettings object with the correct options.
       XmlWriterSettings settings = new XmlWriterSettings();
       settings.Indent = true;
       settings.IndentChars = ("\t");
       settings.OmitXmlDeclaration = true;

       // Create the XmlWriter object and write some content.
       writer = XmlWriter.Create("data.xml", settings);
       writer.WriteStartElement("book");
       writer.WriteElementString("item", "tesing");
       writer.WriteEndElement();
    
       writer.Flush();
     }
     finally  {
        if (writer != null)
          writer.Close();
     }
  }
}

Imports System.IO
Imports System.Xml
Imports System.Text

Public Class Sample 

  Public Shared Sub Main() 
  
    Dim writer As XmlWriter = Nothing

    Try 

       ' Create an XmlWriterSettings object with the correct options. 
       Dim settings As XmlWriterSettings = New XmlWriterSettings()
       settings.Indent = true
       settings.IndentChars = (ControlChars.Tab)
       settings.OmitXmlDeclaration = true

       ' Create the XmlWriter object and write some content.
       writer = XmlWriter.Create("data.xml", settings)
       writer.WriteStartElement("book")
       writer.WriteElementString("item", "tesing")
       writer.WriteEndElement()
    
       writer.Flush()

      Finally
         If Not (writer Is Nothing) Then
            writer.Close()
         End If
      End Try

   End Sub 
End Class

Remarques

Cette propriété s’applique uniquement aux XmlWriter instances qui génèrent du contenu de texte ; sinon, ce paramètre est ignoré.

Les éléments sont mis en retrait tant que l’élément ne contient pas de contenu mixte. Une fois que la méthode ou WriteWhitespace l’option WriteString est appelée pour écrire un contenu d’élément mixte, la XmlWriter mise en retrait s’arrête. Le retrait reprend une fois l’élément de contenu mixte fermé.