XmlValidatingReader.EntityHandling Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit une valeur qui spécifie la façon dont le lecteur gère les entités.
public:
property System::Xml::EntityHandling EntityHandling { System::Xml::EntityHandling get(); void set(System::Xml::EntityHandling value); };public System.Xml.EntityHandling EntityHandling { get; set; }member this.EntityHandling : System.Xml.EntityHandling with get, setPublic Property EntityHandling As EntityHandlingValeur de propriété
Une des EntityHandling valeurs. Si aucune valeur n’est EntityHandling spécifiée, elle est définie par défaut sur EntityHandling.ExpandEntities.
Exceptions
La valeur non valide a été spécifiée.
Remarques
Note
La XmlValidatingReader classe est obsolète dans .NET Framework 2.0. Vous pouvez créer une instance de XmlReader validation à l’aide de la XmlReaderSettings classe et de la Create méthode. Pour plus d'informations, consultez la section Notes de la page de référence XmlReader.
Cette propriété peut être modifiée et prend effet après l’appel suivant Read .
Lorsqu’elle EntityHandling est définie ExpandCharEntitiessur , les valeurs d’attribut ne sont normalisées que partiellement. Le lecteur normalise chaque nœud de texte individuel indépendamment du contenu des nœuds de référence d’entité adjacents.
Pour illustrer la différence entre les modes de gestion des entités, tenez compte du code XML suivant :
<!DOCTYPE doc [<!ENTITY num "123">]>
<doc> A # </doc>
Quand EntityHandling est défini sur ExpandEntities le nœud d’élément « doc » contient un nœud de texte avec le texte d’entité développé :
| Profondeur | NodeType | Nom | Valeur |
|---|---|---|---|
| 1 | Texte | A 123 |
Quand EntityHandling est défini ExpandCharEntitiessur , et WhitespaceHandling est défini sur Significatif ou All, l’élément « doc » développe l’entité de caractère et retourne l’entité générale en tant que nœud :
| Profondeur | NodeType | Nom | Valeur |
|---|---|---|---|
| 1 | Texte | A | |
| 1 | Référence d'entité | nombre | |
| 1 | SignificantWhitespace |
