Partager via


XmlTextReader.EntityHandling Propriété

Définition

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> &#65; &num; </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

S’applique à

Voir aussi