XmlWriterSettings.IndentChars Vlastnost

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

Sestavení:

System.Xml.dll

Sestavení:

netstandard.dll

Získá nebo nastaví řetězec znaku, který se má použít při odsazení. Toto nastavení se používá, pokud Indent je vlastnost nastavena na 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

Hodnota vlastnosti

String

Řetězec znaků, který se má použít při odsazení. Můžete ho nastavit na libovolnou řetězcovou hodnotu. Pokud ale chcete zajistit platný kód XML, měli byste zadat pouze platné prázdné znaky, jako jsou znaky mezery, tabulátory, návraty na začátek řádku nebo spojnicové kanály. Výchozí hodnota je dvě mezery.

Výjimky

ArgumentNullException

Hodnota přiřazená k hodnotě IndentChars je null.

Příklady

Následující příklad vytvoří XmlWriter objekt, který používá znak TAB pro odsazení.

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

Poznámky

Tato vlastnost se vztahuje pouze na XmlWriter instance, které výstupní textový obsah; jinak se toto nastavení ignoruje. Vyvolá XmlWriter výjimku, pokud by znaky odsazení vedlo k neplatnému kódu XML.