XmlValidatingReader.ReadString Méthode
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.
Lit le contenu d’un nœud d’élément ou de texte sous forme de chaîne.
public:
override System::String ^ ReadString();public override string ReadString();override this.ReadString : unit -> stringPublic Overrides Function ReadString () As StringRetours
Contenu du nœud d’élément ou de texte. Il peut s’agir d’une chaîne vide si le lecteur est positionné sur un autre élément ou nœud de texte, ou s’il n’y a plus de contenu de texte à retourner dans le contexte actuel.
Remarques
Le nœud de texte peut être un élément ou un nœud de texte d’attribut.
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.
Si elle est positionnée sur un élément, ReadString concatène tout le texte, l’espace blanc significatif, l’espace blanc et le nœud de section CDATA ensemble et retourne les données concaténées comme contenu de l’élément. Le lecteur s’arrête lorsqu’un balisage est rencontré, y compris les commentaires et les instructions de traitement. Cela peut se produire dans un modèle de contenu mixte ou lorsqu’une balise de fin d’élément est lue.
Si elle est positionnée sur un nœud de texte, ReadString effectue la même concaténation entre le nœud de texte et la balise de fin de l’élément. Si le lecteur est positionné sur un nœud de texte d’attribut, ReadString a la même fonctionnalité que si le lecteur était positionné sur la balise de début de l’élément. Elle retourne tous les nœuds de texte de l’élément concaténé.
La EntityHandling propriété détermine le ReadString fonctionnement comme suit :
| Valeur | Description |
|---|---|
| ExpandEntities | Retourne un caractère développé et des entités générales. Il s’agit de la valeur par défaut. |
| ExpandCharEntities | Retourne le contenu du texte jusqu’à ce qu’il n’inclue pas de référence d’entité générale. Cela signifie qu’une entité générale entraîne l’arrêt de ReadString. Vous devez appeler Read pour effectuer un pas à pas sur la référence d’entité. |
