XmlTextWriter.Formatting Özellik

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Kaynak:

XmlTextWriter.cs

Çıkışın nasıl biçimlendirildiğini gösterir.

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

Özellik Değeri

Formatting

Değerlerden Formatting biri. Varsayılan değerdir Formatting.None (özel biçimlendirme yoktur).

Örnekler

Aşağıdaki örnek bir XML parçası yazar.

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

Açıklamalar

Uyarı

XmlWriter öneririz ki, yeni işlevlerden yararlanmak için XmlWriter.Create yöntemi ve XmlWriterSettings sınıfını kullanarak örnekler oluşturun.

Indented Seçenek ayarlanırsa, alt öğeler ve IndentChar özellikleri kullanılarak Indentation girintilenir. Yalnızca öğe içeriği girintili. Aşağıdaki C# kodu karışık içerik de dahil olmak üzere HTML öğelerini yazar:

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

Yukarıdaki kod aşağıdaki çıkışı oluşturur:

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

Bu, HTML olarak görüntülendiğinde kalın ve italik öğeler arasında boşluk görüntülenmez. Aslında, bu örnekte, bu öğeler arasına girintileme eklenmişse "Fil" sözcüğü yanlış şekilde bozulur.

Uyarı

Hariç herhangi bir metin içeriği yazmak, String.Empty bu öğeyi karma içerik moduna geçirir. Alt öğeler bu "karma" mod durumunu devralmıyor. Bir "karma" öğesinin alt öğesi de "karma" içerik içermediği sürece girintileme yapar. Öğe içeriği ve karma içerik , bu terimlerin XML 1.0 tanımlarına göre tanımlanır.

Ayrıca bkz.

• Formatting