XmlTextWriter.Formatting Eigenschaft

Definition

Namespace:

System.Xml

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Quelle:

XmlTextWriter.cs

Gibt an, wie die Ausgabe formatiert ist.

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 spezielle Formatierung).

Beispiele

Im folgenden Beispiel wird ein XML-Fragment geschrieben.

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

Wir empfehlen Ihnen, XmlWriter Instanzen mithilfe der XmlWriter.Create Methode und der XmlWriterSettings Klasse zu erstellen, um von neuen Funktionen zu profitieren.

Wenn die Indented Option festgelegt ist, werden untergeordnete Elemente mit den Indentation Eigenschaften IndentChar eingezogen. Nur Elementinhalt wird 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 Leerraum zwischen den fetten und kursiven Elementen angezeigt. In diesem Beispiel wäre das Wort "Elephant" in diesem Beispiel falsch unterbrochen, wenn der Einzug zwischen diesen Elementen hinzugefügt wurde.

Hinweis

Durch das Schreiben von Textinhalten wird dieses Element in den Gemischten Inhaltsmodus versetzt String.Empty . Untergeordnete Elemente erben diesen Status des gemischten Modus nicht. Ein untergeordnetes Element eines gemischten Elements führt einen Einzug durch, es sei denn, es enthält auch gemischten Inhalt. Elementinhalte und gemischte Inhalte werden gemäß den XML 1.0-Definitionen dieser Begriffe definiert.

Weitere Informationen

• Formatting