XmlWriterSettings.IndentChars 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 la chaîne de caractères à utiliser au moment de la mise en retrait. Ce paramètre est utilisé lorsque la propriété Indent a la valeur true.

public:
 property System::String ^ IndentChars { System::String ^ get(); void set(System::String ^ value); };

public string IndentChars { get; set; }

member this.IndentChars : string with get, set

Public Property IndentChars As String

Valeur de propriété

String

Chaîne de caractères à utiliser au moment de la mise en retrait. Elle peut avoir n'importe quelle valeur de chaîne. Toutefois, pour garantir la validité du XML, vous devez spécifier uniquement des caractères d'espace blanc valides, tels que les espaces, les tabulations, les retours chariot ou les sauts de ligne. Par défaut, il s'agit de deux espaces.

Exceptions

ArgumentNullException

La valeur assignée à IndentChars est null.

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é. L’exception XmlWriter lève une exception si les caractères de retrait entraînent un xml non valide.