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 si la vérification des caractères doit être assurée.
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 assurer 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 de lever un XmlException si des caractères se trouvent en dehors de la plage des caractères XML légaux. Lorsque la vérification des caractères est activée, vous êtes assuré que :
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 2.3 Common Syntactic Constructs de la recommandation W3C XML 1.0.
Lorsque cette propriété a la truevaleur , qui est le paramètre par défaut, une XmlException 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 commence par un nombre).
Si le XmlReader traite des données de texte, il vérifie toujours que les noms XML et le contenu de texte sont valides, indépendamment du paramètre de propriété. L'attribution à CheckCharacters de la valeur false désactive la vérification de caractères pour la recherche de références d'entité de caractère.
