Condividi tramite


XmlReaderSettings.CheckCharacters Proprietà

Definizione

Ottiene o imposta un valore che indica se eseguire il controllo dei caratteri.

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

Valore della proprietà

Boolean

true per eseguire il controllo dei caratteri; in caso contrario, false. Il valore predefinito è true.

Commenti

Questa proprietà indica al lettore XML di controllare i caratteri nei dati XML che legge e genera un XmlException valore se i caratteri non sono compresi nell'intervallo di caratteri XML legali. Quando è abilitato il controllo dei caratteri, è garantito quanto segue:

Quando questa proprietà è impostata su true, ovvero l'impostazione predefinita, viene generata un'eccezione XmlException se il file XML contiene caratteri non validi o nomi XML non validi, ad esempio un nome di elemento inizia con un numero.

Se l'oggetto XmlReader elabora dati di testo, controlla sempre che i nomi XML e il contenuto del testo siano validi, indipendentemente dall'impostazione della proprietà. Se si imposta la proprietà CheckCharacters su false, il controllo dei caratteri per i riferimenti a entità carattere viene disattivato.

Si applica a