XmlWriterSettings.OmitXmlDeclaration Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit une valeur indiquant si une déclaration XML doit être omise.
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 BooleanValeur de propriété
true pour omettre la déclaration XML ; sinon, false. La valeur par défaut est false, une déclaration XML est écrite.
Exemples
L’exemple suivant écrit un fragment XML dans un flux de mémoire.
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.
Remarques
Cette propriété s’applique uniquement aux XmlWriter instances qui génèrent du contenu de texte ; sinon, ce paramètre est ignoré.
Si OmitXmlDeclaration la valeur est définie false, la déclaration XML est écrite automatiquement
La déclaration XML est toujours écrite si ConformanceLevel elle est définie Documentsur , même si OmitXmlDeclaration elle est définie truesur .
La déclaration XML n’est jamais écrite si ConformanceLevel elle est définie Fragmentsur . Vous pouvez appeler WriteProcessingInstruction pour écrire explicitement une déclaration XML.