XmlWriterSettings.IndentChars XmlWriterSettings.IndentChars XmlWriterSettings.IndentChars XmlWriterSettings.IndentChars Property

Definition

Ruft die Zeichenfolge ab, die für den Einzug verwendet werden soll, oder legt diese fest.Gets or sets the character string to use when indenting. Diese Einstellung wird verwendet, wenn die Indent-Eigenschaft auf true festgelegt ist.This setting is used when the Indent property is set to 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 für den Einzug zu verwendende Zeichenfolge.The character string to use when indenting. Diese kann auf jeden Zeichenfolgenwert festgelegt werden.This can be set to any string value. Wenn Sie die Gültigkeit des XML-Codes sicherstellen möchten, sollten Sie jedoch nur gültige Leerraumzeichen, z. B. Leerzeichen, Tabstoppzeichen, Wagenrückläufe oder Zeilenvorschübe angeben.However, to ensure valid XML, you should specify only valid white space characters, such as space characters, tabs, carriage returns, or line feeds. Der Standard beträgt zwei Leerzeichen.The default is two spaces.

Ausnahmen

Der IndentChars zugewiesene Wert ist null.The value assigned to the IndentChars is null.

Beispiele

Im folgenden Beispiel wird ein XmlWriter -Objekt erstellt, das das Tabstopp Zeichen für Einzug verwendet.The following example creates an XmlWriter object that uses the TAB character for indentation.

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 Text Inhalt ausgeben; andernfalls wird diese Einstellung ignoriert.This property only applies to XmlWriter instances that output text content; otherwise, this setting is ignored. XmlWriter Löst eine Ausnahme aus, wenn die Einzugs Zeichen zu ungültigem XML-Code führen würden.The XmlWriter throws an exception if the indent characters would result in invalid XML.

Gilt für: