XmlReaderSettings.CheckCharacters Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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, setPublic Property CheckCharacters As BooleanValore della proprietà
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:
I caratteri si trovano all'interno dell'intervallo di caratteri XML legali, come definito dalla sezione 2.2 Caratteri della raccomandazione W3C XML 1.0.
Tutti i nomi XML sono validi, come definito dalla sezione Costrutti sintattici comuni della raccomandazione W3C XML 1.0.
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.