Freigeben über


XmlTextWriter.Formatting Eigenschaft

Definition

Gibt die Formatierung der Ausgabe an.

public:
 property System::Xml::Formatting Formatting { System::Xml::Formatting get(); void set(System::Xml::Formatting value); };
public System.Xml.Formatting Formatting { get; set; }
member this.Formatting : System.Xml.Formatting with get, set
Public Property Formatting As Formatting

Eigenschaftswert

Formatting

Einer der Formatting-Werte. Der Standardwert ist Formatting.None (keine besondere Formatierung).

Beispiele

Im folgenden Beispiel wird ein XML-Fragment geschrieben.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   //Create a writer to write XML to the console.
   XmlTextWriter^ writer = nullptr;
   writer = gcnew XmlTextWriter( Console::Out );
   
   //Use indentation for readability.
   writer->Formatting = Formatting::Indented;
   writer->Indentation = 4;
   
   //Write an element (this one is the root).
   writer->WriteStartElement( "book" );
   
   //Write the title element.
   writer->WriteStartElement( "title" );
   writer->WriteString( "Pride And Prejudice" );
   writer->WriteEndElement();
   
   //Write the close tag for the root element.
   writer->WriteEndElement();
   
   //Write the XML to file and close the writer.
   writer->Close();
}
using System;
using System.IO;
using System.Xml;

public class Sample
{

  public static void Main()
  {
     //Create a writer to write XML to the console.
     XmlTextWriter writer = null;
     writer = new XmlTextWriter (Console.Out);

     //Use indentation for readability.
     writer.Formatting = Formatting.Indented;
     writer.Indentation = 4;

     //Write an element (this one is the root).
     writer.WriteStartElement("book");

     //Write the title element.
     writer.WriteStartElement("title");
     writer.WriteString("Pride And Prejudice");
     writer.WriteEndElement();

     //Write the close tag for the root element.
     writer.WriteEndElement();

     //Write the XML to file and close the writer.
     writer.Close();
  }
}
Option Explicit
Option Strict

Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        'Create a writer to write XML to the console.
        Dim writer As XmlTextWriter = Nothing
        writer = New XmlTextWriter(Console.Out)
        
        'Use indentation for readability.
        writer.Formatting = Formatting.Indented
        writer.Indentation = 4
        
        'Write an element (this one is the root).
        writer.WriteStartElement("book")
        
        'Write the title element.
        writer.WriteStartElement("title")
        writer.WriteString("Pride And Prejudice")
        writer.WriteEndElement()
        
        'Write the close tag for the root element.
        writer.WriteEndElement()
        
        'Write the XML to file and close the writer.
        writer.Close()
    End Sub
End Class

Hinweise

Hinweis

Ab dem .NET Framework 2.0 empfehlen wir, Instanzen mithilfe der Methode und der XmlWriter.Create XmlWriterSettings Klasse zu erstellenXmlWriter, um neue Funktionen zu nutzen.

Wenn die Option festgelegt ist, werden untergeordnete Elemente mithilfe der Indented Indentation eigenschaften IndentChar eingezogen. Nur Elementinhalte werden eingerückt. Der folgende C#-Code schreibt HTML-Elemente einschließlich gemischter Inhalte aus:

XmlTextWriter w = new XmlTextWriter(Console.Out);   
 w.Formatting = Formatting.Indented;   
 w.WriteStartElement("ol");   
 w.WriteStartElement("li");   
 w.WriteString("The big "); // This means "li" now has a mixed content model.  
 w.WriteElementString("b", "E");   
 w.WriteElementString("i", "lephant");   
 w.WriteString(" walks slowly.");   
 w.WriteEndElement();   
 w.WriteEndElement();  

Der obige Code erzeugt die folgende Ausgabe:

<ol>   
  <li>The big <b>E</b><i>lephant</i> walks slowly.</li>   
</ol>  

Wenn dies in HTML angezeigt wird, wird kein Leerzeichen zwischen den fetten und kursiven Elementen angezeigt. In diesem Beispiel würde das Wort "Elephant" in diesem Beispiel falsch unterbrochen, wenn der Einzug zwischen diesen Elementen hinzugefügt wurde.

Hinweis

Schreiben von Textinhalten, ohne String.Empty dieses Element in den gemischten Inhaltsmodus zu setzen. Untergeordnete Elemente erben diesen "gemischten" Modusstatus nicht. Ein untergeordnetes Element eines "mixed"-Elements wird eingezogen, es sei denn, es enthält auch "gemischte" Inhalte. Elementinhalte und gemischte Inhalte werden gemäß den XML 1.0-Definitionen dieser Begriffe definiert.

Gilt für

Siehe auch