XmlWriterSettings.IndentChars Tulajdonság

Definíció

Névtér:

System.Xml

Szerelvény:

System.Xml.dll

Lekéri vagy beállítja a behúzáskor használni kívánt karaktersztringet. Ezt a beállítást akkor használja a rendszer, ha a Indent tulajdonság értéke 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

Tulajdonság értéke

String

A behúzáskor használandó karaktersztring. Ez bármilyen sztringértékre beállítható. Az érvényes XML-érték biztosításához azonban csak érvényes szóköz karaktereket kell megadnia, például szóköz karaktereket, tabulátorokat, kocsivisszajeleket vagy vonalcsatornákat. Az alapértelmezett érték két szóköz.

Kivételek

ArgumentNullException

A hozzárendelt érték a IndentChars következő null.

Példák

Az alábbi példa létrehoz egy XmlWriter objektumot, amely a TAB karaktert használja a behúzáshoz.

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

Megjegyzések

Ez a tulajdonság csak azokra a XmlWriter példányokra vonatkozik, amelyek szöveges tartalmat adnak ki; ellenkező esetben a rendszer figyelmen kívül hagyja ezt a beállítást. Ez XmlWriter kivételt eredményez, ha a behúzási karakterek érvénytelen XML-t eredményeznek.