XmlWriterSettings.OmitXmlDeclaration Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of een XML-declaratie moet worden weggelaten.
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 BooleanWaarde van eigenschap
true om de XML-declaratie weg te laten; anders, false. De standaardwaarde is false, er wordt een XML-declaratie geschreven.
Voorbeelden
In het volgende voorbeeld wordt een XML-fragment naar een geheugenstroom geschreven.
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.
Opmerkingen
Deze eigenschap is alleen van toepassing op XmlWriter exemplaren die tekstinhoud uitvoeren. Anders wordt deze instelling genegeerd.
Als OmitXmlDeclaration dit is ingesteld op false, wordt de XML-declaratie automatisch geschreven
De XML-declaratie wordt altijd geschreven als ConformanceLevel deze is ingesteld op Document, zelfs als OmitXmlDeclaration deze is ingesteld op true.
De XML-declaratie wordt nooit geschreven als ConformanceLevel deze is ingesteld op Fragment. U kunt aanroepen WriteProcessingInstruction om expliciet een XML-declaratie uit te schrijven.