XmlTextReader.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, set
Public Property EntityHandling As EntityHandling
Valeur de propriété
Une des EntityHandling valeurs. Si aucune valeur n’est EntityHandling spécifiée, elle est EntityHandling.ExpandCharEntitiesdéfinie par défaut sur .
Remarques
Note
Nous vous recommandons de créer des instances XmlReader à l’aide de la méthode XmlReader.Create pour tirer parti de nouvelles fonctionnalités.
Cette propriété peut être modifiée à la volé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 | Type de nœud | Nom | Valeur |
|---|---|---|---|
| 1 | Text |
A 123 |
Lorsqu’il EntityHandling est défini ExpandCharEntitiessur , et WhitespaceHandling est défini sur Significant 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 | Type de nœud | Nom | Valeur |
|---|---|---|---|
| 1 | Text |
A | |
| 1 | EntityReference |
nombre | |
| 1 | SignificantWhitespace |