ConformanceLevel Énumération

Définition

Spécifie l’ampleur des contrôles d’entrée ou de sortie que les objets XmlReader et XmlWriter effectuent.

public enum class ConformanceLevel
public enum ConformanceLevel
type ConformanceLevel = 
Public Enum ConformanceLevel
Héritage
ConformanceLevel

Champs

Auto 0

L’objet XmlReader ou XmlWriter détecte automatiquement si une vérification au niveau du document ou du fragment doit être effectuée et procède au contrôle approprié. Si vous enveloppez (wrap) un autre objet XmlReader ou XmlWriter, l’objet externe n’effectue aucune vérification de conformité supplémentaire. Le contrôle de conformité doit être fait par l'objet sous-jacent.

Pour plus de détails sur la détermination du niveau de conformité, consultez les propriétés ConformanceLevel et ConformanceLevel.

Document 2

Les données XML respectent les règles définissant un document XML 1.0 bien formé, tel que défini dans W3C. Ce niveau de vérification garantit que tout processeur peut utiliser le flux en cours de lecture ou d'écriture comme document XML 1.0.

Fragment 1

Les données XML sont un fragment XML bien formé, tel que défini dans W3C. Ce niveau de conformité représente un document XML qui peut ne pas comporter d'élément racine, mais qui est par ailleurs bien formé. Ce niveau de vérification garantit que tout processeur peut utiliser le flux en cours de lecture ou d'écriture comme entité analysée externe XML 1.0.

Remarques

Lorsque vous créez une instance de lecteur ou d’enregistreur XML, vous pouvez utiliser la XmlReaderSettings classe ou XmlWriterSettings pour spécifier les fonctionnalités que vous souhaitez que la nouvelle instance prend en charge. L’une des fonctionnalités que vous pouvez configurer est le niveau de conformité que vous souhaitez appliquer aux données XML.

La création d’un lecteur ou d’un enregistreur conforme garantit que les données XML en cours de traitement sont conformes au niveau de conformité spécifié. Si le flux lu ou écrit n’est pas conforme au niveau de conformité, une exception est levée.

Les vérifications au niveau du document avec le ConformanceLevel.Document membre d’énumération appliquent des vérifications au niveau des fragments (le ConformanceLevel.Fragment membre) et garantissent également les points suivants :

  • L’élément de niveau supérieur n’a pas de nœuds autres que la déclaration XML, DTD, l’élément, le commentaire, l’espace blanc ou l’instruction de traitement.

  • Les données XML ont un seul nœud d’élément de niveau supérieur.

S’applique à

Voir aussi