XmlDocument.CreateSignificantWhitespace(String) Método

Definição

Cria um nó XmlSignificantWhitespace.Creates an XmlSignificantWhitespace node.

public:
 virtual System::Xml::XmlSignificantWhitespace ^ CreateSignificantWhitespace(System::String ^ text);
public virtual System.Xml.XmlSignificantWhitespace CreateSignificantWhitespace (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 de caracteres deve conter somente os seguintes caracteres  
 
 e 	The string must contain only the following characters  
 
 and 	

Retornos

XmlSignificantWhitespace

Um novo nó XmlSignificantWhitespace.A new XmlSignificantWhitespace node.

Exemplos

O exemplo a seguir adiciona um espaço em branco significativo ao documento.The following example adds significant white space to the document.

#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew 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 );
}

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

Comentários

Esse método é uma extensão da Microsoft para o Modelo de Objeto do Documento (DOM).This method is a Microsoft extension to the Document Object Model (DOM). Ele é usado quando você deseja formatar manualmente o documento.It is used when you want to manually format your document.

Embora esse método crie o novo objeto no contexto do documento, ele não adiciona automaticamente o novo objeto à árvore de documentos.Although this method creates the new object in the context of the document, it does not automatically add the new object to the document tree. Para adicionar o novo objeto, você deve chamar explicitamente um dos métodos de inserção de nó.To add the new object, you must explicitly call one of the node insert methods.

Aplica-se a