XmlTextReader.EntityHandling Propriété

Définition

Obtient ou définit une valeur qui spécifie le mode de gestion des entités par le lecteur.

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 valeurs de l'objet EntityHandling. Si aucun EntityHandling n'est spécifié, il prend par défaut la valeur EntityHandling.ExpandCharEntities.

Remarques

Notes

À compter de .NET Framework 2.0, nous vous recommandons de créer XmlReader des instances à l’aide de la XmlReader.Create méthode pour tirer parti des nouvelles fonctionnalités.

Cette propriété peut être modifiée à la volée et prend effet après l’appel suivant Read .

Lorsque EntityHandling a la valeur ExpandCharEntities, les valeurs d’attribut ne sont que partiellement normalisées. 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 de l’entité développée :

Profondeur Type de nœud Nom Valeur
1 Text A 123

Lorsque EntityHandling a la ExpandCharEntitiesvaleur et WhitespaceHandling que a la Significant valeur ou All, l’élément « doc » développe l’entité character et retourne l’entité générale en tant que nœud :

Profondeur Type de nœud Nom Valeur
1 Text A
1 EntityReference num
1 SignificantWhitespace

S’applique à

Voir aussi