XmlReaderSettings.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é appliqué par le lecteur XML. La valeur par défaut est Document.

Exemples

L’exemple suivant crée un XmlReader objet qui lit un fragment XML.

string xmlFrag ="<item rk:ID='abc-23'>hammer</item> " +
                        "<item rk:ID='r2-435'>paint</item>" +
                        "<item rk:ID='abc-39'>saw</item>";

// Create the XmlNamespaceManager.
NameTable nt = new NameTable();
XmlNamespaceManager nsmgr = new XmlNamespaceManager(nt);
nsmgr.AddNamespace("rk", "urn:store-items");

// Create the XmlParserContext.
XmlParserContext context = new XmlParserContext(null, nsmgr, null, XmlSpace.None);

// Create the reader.
XmlReaderSettings settings = new XmlReaderSettings();
settings.ConformanceLevel = ConformanceLevel.Fragment;
XmlReader reader = XmlReader.Create(new StringReader(xmlFrag), settings, context);

Dim xmlFrag As String = "<item rk:ID='abc-23'>hammer</item> " & _
                                     "<item rk:ID='r2-435'>paint</item>" & _
                                     "<item rk:ID='abc-39'>saw</item>"

' Create the XmlNamespaceManager.
Dim nt As New NameTable()
Dim nsmgr As New XmlNamespaceManager(nt)
nsmgr.AddNamespace("rk", "urn:store-items")

' Create the XmlParserContext.
Dim context As New XmlParserContext(Nothing, nsmgr, Nothing, XmlSpace.None)

' Create the reader. 
Dim settings As New XmlReaderSettings()
settings.ConformanceLevel = ConformanceLevel.Fragment
Dim reader As XmlReader = XmlReader.Create(New StringReader(xmlFrag), settings, context)

Remarques

Les lecteurs XML créés par la Create méthode répondent aux exigences de conformité suivantes par défaut :

• Les nouvelles lignes et la valeur d’attribut sont normalisées en fonction de la recommandation W3C XML 1.0.

• Toutes les entités sont automatiquement développées.

• Les attributs par défaut déclarés dans la définition de type de document sont toujours ajoutés même lorsque le lecteur ne valide pas.

• La déclaration du préfixe XML mappé à l’URI d’espace de noms XML correct est autorisée.

• Les noms de notation dans une déclaration d’attribut unique NotationType et NmTokens dans une déclaration d’attribut unique Enumeration sont distincts.

Vous pouvez utiliser la ConformanceLevel propriété pour vérifier et garantir que le flux lu est conforme aux règles d’un document XML 1.0 bien formé ou d’un fragment de document. Si les données ne sont pas conformes, une XmlException exception est levée. La valeur par défaut est ConformanceLevel.Document (conformité au niveau du document).

Les trois niveaux de conformité sont les suivants :

Voici comment le lecteur gère des violations de conformité spécifiques en fonction du paramètre de la ConformanceLevel propriété :

S’applique à

Voir aussi

• Create(String)