XmlWriterSettings.IndentChars 屬性

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

來源:

XmlWriterSettings.cs

取得或設定縮排時使用的字元字串。 當 Indent 屬性設為 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

屬性值

String

縮排時使用的字元字串。 它可以設為任何字串值。 不過，若要確保有效的 XML，您應該只指定有效的空白字元 (例如，空格字元、定位字元、歸位字元或換行符號)。 預設值為兩個空格。

例外狀況

ArgumentNullException

指派至 IndentChars 的值為 null。

範例

下列範例會 XmlWriter 建立物件，該物件會使用 TAB 字元進行縮排。

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

備註

此屬性僅適用于 XmlWriter 輸出文字內容的實例，否則會忽略此設定。 如果縮排字元會導致不正確 XML，則會 XmlWriter 擲回例外狀況。