XmlWriterSettings.IndentChars Propriedade

Definição

Especifica ou define a cadeia de caracteres a ser usada ao recuar.Gets or sets the character string to use when indenting. Esta configuração é usada quando a propriedade Indent for definida como true.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

Valor da propriedade

String

A cadeia de caracteres a ser usada ao recuar.The character string to use when indenting. Isso pode ser definido para qualquer valor de cadeia de caracteres.This can be set to any string value. No entanto, para garantir um XML válido, você deve especificar somente caracteres de espaço em branco válidos, como caracteres de espaço, tabulações, retornos de carro ou alimentações de linha.However, to ensure valid XML, you should specify only valid white space characters, such as space characters, tabs, carriage returns, or line feeds. O padrão é os dois espaços.The default is two spaces.

Exceções

O valor atribuído ao IndentChars é null.The value assigned to the IndentChars is null.

Exemplos

O exemplo a seguir cria um XmlWriter objeto que usa o caractere de tabulação para recuo.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 

Comentários

Essa propriedade só se aplica a XmlWriter instâncias que geram conteúdo de texto; caso contrário, essa configuração é ignorada.This property only applies to XmlWriter instances that output text content; otherwise, this setting is ignored. O XmlWriter gera uma exceção se os caracteres de recuo resultarem em XML inválido.The XmlWriter throws an exception if the indent characters would result in invalid XML.

Aplica-se a