XmlWriterSettings.IndentChars Propiedad

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

Source:

XmlWriterSettings.cs

Obtiene o establece la cadena de caracteres que se va a usar al aplicar sangría. Esta opción se utiliza cuando la propiedad Indent se establece en 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 de propiedad

String

Cadena de caracteres que se va a usar al aplicar sangría. Se puede establecer en cualquier valor de cadena. Sin embargo, para garantizar la validez del contenido XML, debe especificar solo caracteres de espacio en blanco válidos, como caracteres de espacio, tabulaciones, retornos de carro y saltos de línea. El valor predeterminado es dos espacios.

Excepciones

ArgumentNullException

El valor asignado a IndentChars es null.

Ejemplos

En el ejemplo siguiente se crea un XmlWriter objeto que usa el carácter TAB para la sangría.

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

Comentarios

Esta propiedad solo se aplica a XmlWriter instancias que generan contenido de texto; de lo contrario, se omite esta configuración. XmlWriter produce una excepción si los caracteres de sangría darían lugar a XML no válido.