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

Definition

Ruft einen Wert ab, der angibt, ob eine XML-Deklaration ausgelassen 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 folgende Beispiel schreibt ein XML-Fragment in einen Speicherdatenstrom.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 auszugeben; andernfalls wird diese Einstellung ignoriert.This property only applies to XmlWriter instances that output text content; otherwise, this setting is ignored.

Wenn OmitXmlDeclaration nastaven NA hodnotu false, automatisch die XML-Deklaration geschriebenIf OmitXmlDeclaration is set to false, The XML declaration is written automatically

Die XML-Deklaration wird immer geschrieben werden, wenn ConformanceLevel nastaven NA hodnotu Document, auch wenn OmitXmlDeclaration nastaven NA hodnotu true.The XML declaration is always written if ConformanceLevel is set to Document, even if OmitXmlDeclaration is set to true.

Die XML-Deklaration werden nicht geschrieben werden, wenn ConformanceLevel nastaven NA hodnotu Fragment.The XML declaration is never written if ConformanceLevel is set to Fragment. Rufen Sie WriteProcessingInstruction explizit eine XML-Deklaration geschrieben.You can call WriteProcessingInstruction to explicitly write out an XML declaration.

Gilt für: