XmlWriterSettings.OmitXmlDeclaration Properti

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlWriterSettings.cs

Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan menghilangkan deklarasi XML.

public:
 property bool OmitXmlDeclaration { bool get(); void set(bool value); };

public bool OmitXmlDeclaration { get; set; }

member this.OmitXmlDeclaration : bool with get, set

Public Property OmitXmlDeclaration As Boolean

Nilai Properti

Boolean

true untuk menghilangkan deklarasi XML; jika tidak, false. Defaultnya adalah false, deklarasi XML ditulis.

Contoh

Contoh berikut menulis fragmen XML ke aliran memori.

XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.CloseOutput = false;

// Create the XmlWriter object and write some content.
MemoryStream strm = new MemoryStream();
XmlWriter writer = XmlWriter.Create(strm, settings);
writer.WriteElementString("orderID", "1-456-ab");
writer.WriteElementString("orderID", "2-36-00a");
writer.Flush();
writer.Close();

// Do additional processing on the stream.

Dim settings As XmlWriterSettings = New XmlWriterSettings()
settings.OmitXmlDeclaration = true
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.CloseOutput = false

' Create the XmlWriter object and write some content.
Dim strm as MemoryStream = new MemoryStream()
Dim writer As XmlWriter = XmlWriter.Create(strm, settings)
writer.WriteElementString("orderID", "1-456-ab")
writer.WriteElementString("orderID", "2-36-00a")
writer.Flush()
writer.Close()

' Do additional processing on the stream.

Keterangan

Properti ini hanya berlaku untuk XmlWriter instans yang mengeluarkan konten teks; jika tidak, pengaturan ini diabaikan.

Jika OmitXmlDeclaration diatur ke false, Deklarasi XML ditulis secara otomatis

Deklarasi XML selalu ditulis jika ConformanceLevel diatur ke Document, bahkan jika OmitXmlDeclaration diatur ke true.

Deklarasi XML tidak pernah ditulis jika ConformanceLevel diatur ke Fragment. Anda dapat memanggil WriteProcessingInstruction untuk menulis deklarasi XML secara eksplisit.