Partager via


XmlWriterSettings.OmitXmlDeclaration Propriété

Définition

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, set
Public Property OmitXmlDeclaration As Boolean

Valeur de propriété

Boolean

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.

S’applique à