Nyelv

XmlTextWriter.Formatting Tulajdonság

Definíció

A kimenet formázását jelzi.

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

Tulajdonság értéke

Az egyik Formatting érték. Az alapértelmezett beállítás Formatting.None (nincs speciális formázás).

Példák

Az alábbi példa egy XML-töredéket ír.

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

Megjegyzések

Note

Javasoljuk, hogy a XmlWriter metódus és a XmlWriter.Create osztály használatával hozzon létre XmlWriterSettings példányokat az új funkciók előnyeinek kihasználásához.

Ha a Indented beállítás be van állítva, a gyermekelemek behúzása a tulajdonságok és Indentation a IndentChar tulajdonságok használatával történik. Csak az elem tartalma van behúzva. A következő C#-kód HTML-elemeket ír ki, beleértve a vegyes tartalmakat is:

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

A fenti kód a következő kimenetet hozza létre:

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

Ha ezt HTML-ben tekinti meg, a félkövér és dőlt elemek között nem jelenik meg szabad terület. Valójában ebben a példában, ha behúzást adna ezek közé az elemek közé, az "Elefánt" szó helytelenül hibás lenne.

Note

Bármilyen szöveges tartalom írása, kivéve String.Empty , ha ezt az elemet vegyes tartalom módba helyezi. A gyermekelemek nem öröklik ezt a "vegyes" üzemmód állapotát. A "vegyes" elem gyermekeleme behúzást végez, kivéve, ha "vegyes" tartalmat is tartalmaz. Az elemtartalom és a vegyes tartalom ezen kifejezések XML 1.0-s definíciói szerint van definiálva.

A következőre érvényes:

Lásd még