XmlReaderSettings.CheckCharacters Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Zeichenprüfung ausgeführt werden soll.
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 BooleanEigenschaftswert
true zur Zeichenprüfung; andernfalls false. Der Standardwert lautet true.
Hinweise
Diese Eigenschaft weist den XML-Reader an, Zeichen in den XML-Daten zu überprüfen, die gelesen werden, und löst ein XmlException , wenn zeichen außerhalb des Zulässigen XML-Zeichenbereichs liegen. Wenn die Zeichenüberprüfung aktiviert ist, wird Folgendes sichergestellt:
Zeichen befinden sich im Bereich der zulässigen XML-Zeichen, wie im Abschnitt "2.2 Zeichen " der W3C XML 1.0-Empfehlung definiert.
Alle XML-Namen sind gültig, wie im Abschnitt "2.3 Common Syntactic Constructs" der W3C XML 1.0-Empfehlung definiert.
Wenn diese Eigenschaft auf true", was die Standardeinstellung ist, wird eine XmlException Ausnahme ausgelöst, wenn die XML-Datei unzulässige Zeichen oder ungültige XML-Namen enthält (z. B. ein Elementname beginnt mit einer Zahl).
Wenn die XmlReader Textdaten verarbeitet werden, wird immer überprüft, ob die XML-Namen und der Textinhalt gültig sind, unabhängig von der Eigenschaftseinstellung. Das Festlegen von CheckCharacters auf false deaktiviert die Zeichenüberprüfung für Zeichenentitätsreferenzen.