XmlWriterSettings.OmitXmlDeclaration Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví hodnotu určující, zda se má vynechat deklarace 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
Hodnota vlastnosti
true
vynechat deklaraci XML; v opačném případě . false
Výchozí hodnota je false
, deklarace XML je zapsána.
Příklady
Následující příklad zapíše fragment XML do datového proudu paměti.
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.
Poznámky
Tato vlastnost se vztahuje pouze na XmlWriter instance, které výstupní textový obsah, jinak je toto nastavení ignorováno.
Pokud OmitXmlDeclaration je nastavena na false
, deklarace XML se zapisuje automaticky.
Deklarace XML je vždy zapsána, pokud ConformanceLevel je nastavena na Document, i když OmitXmlDeclaration je nastavena na true
.
Deklarace XML není nikdy zapsána, pokud ConformanceLevel je nastavena na Fragment. Můžete volat WriteProcessingInstruction explicitní zápis deklarace XML.