XmlReaderSettings.CheckCharacters 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 indiquant s’il faut effectuer la vérification des caractères.
public:
property bool CheckCharacters { bool get(); void set(bool value); };public bool CheckCharacters { get; set; }member this.CheckCharacters : bool with get, setPublic Property CheckCharacters As BooleanValeur de propriété
true pour effectuer la vérification des caractères ; sinon false. La valeur par défaut est true.
Remarques
Cette propriété indique au lecteur XML de vérifier les caractères dans les données XML qu’il lit et lève un XmlException caractère si des caractères se trouvent en dehors de la plage de caractères XML légaux. Lorsque la vérification des caractères est activée, vous êtes assuré des éléments suivants :
Les caractères se trouvent dans la plage de caractères XML légaux, comme défini par la section 2.2 Caractères de la recommandation W3C XML 1.0.
Tous les noms XML sont valides, comme défini par la section Constructions syntactiques communes 2.3 de la recommandation W3C XML 1.0.
Lorsque cette propriété est définie truesur , qui est le paramètre par défaut, une exception est levée si le fichier XML contient des caractères non valides ou des noms XML non valides (par exemple, un nom d’élément XmlException commence par un nombre).
Si le XmlReader traitement des données de texte est effectuée, il vérifie toujours que les noms XML et le contenu du texte sont valides, quel que soit le paramètre de propriété. La définition de CheckCharacters à false désactive la vérification des caractères pour les références d'entités de caractères.
