XmlDocument.CreateSignificantWhitespace(String) Método

Definição

Espaço de Nomes:
System.Xml
Assemblagens:
System.Xml.dll, System.Xml.XmlDocument.dll
Assemblagem:
System.Xml.dll
Assemblagem:
netstandard.dll

Cria um XmlSignificantWhitespace nó.

public:
 virtual System::Xml::XmlSignificantWhitespace ^ CreateSignificantWhitespace(System::String ^ text);
public virtual System.Xml.XmlSignificantWhitespace CreateSignificantWhitespace(string text);
abstract member CreateSignificantWhitespace : string -> System.Xml.XmlSignificantWhitespace
override this.CreateSignificantWhitespace : string -> System.Xml.XmlSignificantWhitespace
Public Overridable Function CreateSignificantWhitespace (text As String) As XmlSignificantWhitespace

Parâmetros

text
String

A cadeia deve conter apenas os seguintes caracteres  e .

Devoluções

XmlSignificantWhitespace

Um novo XmlSignificantWhitespace nó.

Exemplos

O exemplo seguinte acrescenta um espaço em branco significativo ao documento.

using System;
using System.Xml;

public class Sample {

  public static void Main() {

      XmlDocument doc = new XmlDocument();
      doc.LoadXml("<author xml:space='preserve'>" +
                  "<first-name>Eva</first-name>"+
                  "<last-name>Corets</last-name>" +
                  "</author>");

      Console.WriteLine("InnerText before...");
      Console.WriteLine(doc.DocumentElement.InnerText);

      // Add white space.
      XmlNode currNode = doc.DocumentElement;
      XmlSignificantWhitespace sigws = doc.CreateSignificantWhitespace("\t");
      currNode.InsertAfter(sigws, currNode.FirstChild);

      Console.WriteLine();
      Console.WriteLine("InnerText after...");
      Console.WriteLine(doc.DocumentElement.InnerText);
  }
}

Option Explicit
Option Strict

Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        
        Dim doc As New XmlDocument()
        doc.LoadXml("<author xml:space='preserve'>" & _
                    "<first-name>Eva</first-name>" & _
                    "<last-name>Corets</last-name>" & _
                    "</author>")
            
        Console.WriteLine("InnerText before...")
        Console.WriteLine(doc.DocumentElement.InnerText)
            
        ' Add white space.    
        Dim currNode as XmlNode = doc.DocumentElement
        Dim sigws As XmlSignificantWhitespace = doc.CreateSignificantWhitespace(ControlChars.Tab)
        currNode.InsertAfter(sigws, currNode.FirstChild)
            
        Console.WriteLine()
        Console.WriteLine("InnerText after...")
        Console.WriteLine(doc.DocumentElement.InnerText)
        
    End Sub 
End Class

Observações

Este método é uma extensão da Microsoft para o Document Object Model (DOM). É usado quando quer formatar manualmente o seu documento.

Embora este método crie o novo objeto no contexto do documento, não adiciona automaticamente o novo objeto à árvore do documento. Para adicionar o novo objeto, deve chamar explicitamente um dos métodos de inserção de nó.

Aplica-se a