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.Specifies the amount of input or output checking that XmlReader and XmlWriter objects perform.

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é.The XmlReader or XmlWriter object automatically detects whether document-level or fragment-level checking should be performed, and does the appropriate checking. Si vous enveloppez (wrap) un autre objet XmlReader ou XmlWriter, l’objet externe n’effectue aucune vérification de conformité supplémentaire.If you're wrapping another XmlReader or XmlWriter object, the outer object doesn't do any additional conformance checking. Le contrôle de conformité doit être fait par l'objet sous-jacent.Conformance checking is left up to the underlying object.

Pour plus de détails sur la détermination du niveau de conformité, consultez les propriétés ConformanceLevel et ConformanceLevel.See the ConformanceLevel and ConformanceLevel properties for details on how the compliance level is determined.

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.The XML data complies with the rules for a well-formed XML 1.0 document, as defined by the 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.This level of checking ensures that the stream being read or written can be consumed by any processor as an XML 1.0 document.

Fragment 1

Les données XML sont un fragment XML bien formé, tel que défini dans W3C.The XML data is a well-formed XML fragment, as defined by the 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é.This conformance level represents an XML document that might not have a root element but is otherwise well-formed. 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.This level of checking ensures that the stream being read or written can be consumed by any processor as an XML 1.0 external parsed entity].

Remarques

Quand vous créez une instance de lecteur ou d’enregistreur XML, vous pouvez utiliser la XmlReaderSettings XmlWriterSettings classe ou pour spécifier les fonctionnalités que la nouvelle instance doit prendre en charge.When you create an XML reader or writer instance, you can use the XmlReaderSettings or XmlWriterSettings class to specify the features that you want the new instance to support. L’une des fonctionnalités que vous pouvez configurer est le niveau de conformité que vous souhaitez appliquer aux données XML.One of the features that you can configure is the level of conformance you want to enforce on the XML data.

La création d’un lecteur ou d’un writer conforme garantit que les données XML en cours de traitement sont conformes au niveau de conformité spécifié.Creating a compliant reader or writer guarantees that the XML data being processed complies with the specified conformance level. Si le flux en cours de lecture ou d’écriture n’est pas conforme au niveau de conformité, une exception est levée.If the stream being read or written doesn't comply with the conformance level, an exception is thrown.

Les vérifications au niveau du document avec le membre de l' ConformanceLevel.Document énumération appliquent des contrôles de niveau fragment (le ConformanceLevel.Fragment membre) et garantissent également les éléments suivants :Document-level checks with the ConformanceLevel.Document enumeration member enforce fragment-level checks (the ConformanceLevel.Fragment member) and also ensure the following:

  • L’élément de niveau supérieur n’a pas de nœuds autres que la déclaration XML, la DTD, l’élément, le commentaire, l’espace blanc ou l’instruction de traitement.The top-level item doesn't have any nodes other than the XML declaration, DTD, element, comment, white space, or processing instruction.

  • Les données XML ne possèdent qu’un seul nœud d’élément de niveau supérieur.The XML data has one and only one top-level element node.

S’applique à

Voir aussi