XmlTextWriter.Formatting Egenskap

Definition

Anger hur utdata formateras.

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

Egenskapsvärde

Ett av Formatting värdena. Standardvärdet är Formatting.None (ingen särskild formatering).

Exempel

I följande exempel skrivs ett XML-fragment.

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

Kommentarer

Note

Vi rekommenderar att du skapar XmlWriter instanser med hjälp av XmlWriter.Create metoden och XmlWriterSettings klassen för att dra nytta av den nya funktionaliteten.

Om alternativet Indented anges dras underordnade element in med egenskaperna Indentation och IndentChar . Endast elementinnehåll är indraget. Följande C#-kod skriver ut HTML-element inklusive blandat innehåll:

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();

Koden ovan ger följande utdata:

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

När detta visas i HTML visas inget tomt utrymme mellan de fetstilt och kursivt element. I det här exemplet skulle ordet "Elefant" vara felaktigt brutet om indrag lades till mellan dessa element.

Note

Om du skriver textinnehåll, exklusive String.Empty placeras elementet i läget för blandat innehåll. Underordnade element ärver inte den här statusen för "blandat" läge. Ett underordnat element i ett "blandat" element gör indrag, såvida det inte också innehåller "blandat" innehåll. Elementinnehåll och blandat innehåll definieras enligt XML 1.0-definitionerna för dessa termer.

Gäller för

Se även