XmlWriterSettings.IndentChars Eigenschaft

Definition

Ruft die beim Einrücken zu verwendende Zeichenfolge ab oder legt sie fest. Diese Einstellung wird verwendet, wenn die Indent Eigenschaft auf 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

Eigenschaftswert

Die zeichenzeichenfolge, die beim Einrücken verwendet werden soll. Dies kann auf einen beliebigen Zeichenfolgenwert festgelegt werden. Um gültige XML-Daten sicherzustellen, sollten Sie jedoch nur gültige Leerzeichen angeben, z. B. Leerzeichen, Tabstopps, Wagenrücklauf oder Zeilenfeeds. Der Standardwert ist zwei Leerzeichen.

Ausnahmen

Der dem IndentChars Wert zugewiesene Wert ist null.

Beispiele

Im folgenden Beispiel wird ein XmlWriter Objekt erstellt, das das TAB-Zeichen für den Einzug verwendet.

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

Hinweise

Diese Eigenschaft gilt nur für XmlWriter Instanzen, die Textinhalte ausgeben. Andernfalls wird diese Einstellung ignoriert. Dies XmlWriter löst eine Ausnahme aus, wenn die Einzugszeichen zu ungültigen XML-Daten führen würden.

Gilt für: