XmlWriterSettings.ConformanceLevel Propriété

public:
 property System::Xml::ConformanceLevel ConformanceLevel { System::Xml::ConformanceLevel get(); void set(System::Xml::ConformanceLevel value); };

public System.Xml.ConformanceLevel ConformanceLevel { get; set; }

member this.ConformanceLevel : System.Xml.ConformanceLevel with get, set

Public Property ConformanceLevel As ConformanceLevel

Valeur de propriété

ConformanceLevel

Une des valeurs d'énumération qui spécifie le niveau de conformité (document, fragment ou détection automatique). La valeur par défaut est Document.

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

La XmlWriterSettings.ConformanceLevel propriété configure l’enregistreur XML pour vérifier et garantir que le flux en cours d’écriture est conforme à un certain ensemble de règles. Les données XML peuvent être vérifiées pour voir qu’elles sont conformes aux règles d’un document XML 1.0 bien formé ou d’un fragment de document. Le tableau suivant décrit les trois paramètres. La valeur par défaut est la conformité au niveau du document.

Si l’enregistreur XML détecte des informations qui ne respectent pas le niveau de conformité spécifié, elle lève une exception. Dans certains cas, l’enregistreur XML corrige automatiquement l’erreur de conformité. Par exemple, l’enregistreur ferme un attribut non fermé sans lever d’exception. Le tableau suivant montre comment diverses violations de conformité sont gérées dans chaque paramètre.

S’applique à