XmlWriterSettings.OmitXmlDeclaration XmlWriterSettings.OmitXmlDeclaration XmlWriterSettings.OmitXmlDeclaration XmlWriterSettings.OmitXmlDeclaration Property

Definition

Ruft einen Wert ab, der angibt, ob eine XML-Deklaration auslassen werden soll, oder legt diesen fest.Gets or sets a value indicating whether to omit an XML declaration.

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

Eigenschaftswert

true, um die XML-Deklaration auszulassen, andernfalls false.true to omit the XML declaration; otherwise, false. Der Standardwert ist false. Es wird eine XML-Deklaration geschrieben.The default is false, an XML declaration is written.

Beispiele

Im folgenden Beispiel wird ein XML-Fragment in einen Speicherstream geschrieben.The following example writes an XML fragment to a memory stream.

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 additonal 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 additonal processing on the stream.

Hinweise

Diese Eigenschaft gilt nur für XmlWriter -Instanzen, die Text Inhalt ausgeben; andernfalls wird diese Einstellung ignoriert.This property only applies to XmlWriter instances that output text content; otherwise, this setting is ignored.

Wenn OmitXmlDeclaration auffalsefestgelegt ist, wird die XML-Deklaration automatisch geschrieben.If OmitXmlDeclaration is set to false, The XML declaration is written automatically

Die XML-Deklaration wird immer ConformanceLevel geschrieben, wenn Documentauf festgelegt OmitXmlDeclaration wird, auch truewenn auf festgelegt ist.The XML declaration is always written if ConformanceLevel is set to Document, even if OmitXmlDeclaration is set to true.

Die XML-Deklaration wird niemals ConformanceLevel geschrieben, wenn Fragmentauf festgelegt ist.The XML declaration is never written if ConformanceLevel is set to Fragment. Sie können aufzurufen WriteProcessingInstruction , um explizit eine XML-Deklaration zu schreiben.You can call WriteProcessingInstruction to explicitly write out an XML declaration.

Gilt für: