XmlTextWriter.Formatting Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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.