XmlReaderSettings.CheckCharacters Propriété

Définition

Espace de noms:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Source:

XmlReaderSettings.cs

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, set

Public Property CheckCharacters As Boolean

Valeur de propriété

Boolean

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.