XmlWriterSettings.OmitXmlDeclaration Eigenschaft

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Source:

XmlWriterSettings.cs

Ruft einen Wert ab, der angibt, ob eine XML-Deklaration ausgelassen werden soll, oder legt diesen fest.

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

Boolean

true, um die XML-Deklaration auszulassen, andernfalls false. Der Standardwert ist false. Es wird eine XML-Deklaration geschrieben.

Beispiele

Im folgenden Beispiel wird ein XML-Fragment in einen Speicherdatenstrom geschrieben.

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.

Hinweise

Diese Eigenschaft gilt nur für XmlWriter Instanzen, die Textinhalt ausgeben, andernfalls wird diese Einstellung ignoriert.

Wenn OmitXmlDeclaration auf falsefestgelegt ist, wird die XML-Deklaration automatisch geschrieben.

Die XML-Deklaration wird immer geschrieben, wenn ConformanceLevel auf Documentfestgelegt ist, auch wenn OmitXmlDeclaration auf truefestgelegt ist.

Die XML-Deklaration wird nie geschrieben, wenn ConformanceLevel auf Fragmentfestgelegt ist. Sie können aufrufen WriteProcessingInstruction , um eine XML-Deklaration explizit auszuschreiben.