XmlWriterSettings.Indent Propriedade

Definição

Obtém ou define um valor que indica se deseja recuar elementos.Gets or sets a value indicating whether to indent elements.

public:
 property bool Indent { bool get(); void set(bool value); };
public bool Indent { get; set; }
member this.Indent : bool with get, set
Public Property Indent As Boolean

Valor da propriedade

Boolean

true para gravar elementos individuais em novas linhas e recuo; caso contrário, false.true to write individual elements on new lines and indent; otherwise, false. O padrão é false.The default is false.

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.

Os elementos são recuados, desde que o elemento não contenha conteúdo misto.The elements are indented as long as the element does not contain mixed content. Depois que WriteString o WriteWhitespace método ou é chamado para gravar um conteúdo de elemento misto, o XmlWriter para de recuar.Once the WriteString or WriteWhitespace method is called to write out a mixed element content, the XmlWriter stops indenting. O recuo será retomado quando o elemento de conteúdo misto for fechado.The indenting resumes once the mixed content element is closed.

Aplica-se a