XmlWriterSettings.OmitXmlDeclaration Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property OmitXmlDeclaration As BooleanEigenschaftswert
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.
