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.
Ruft einen Wert ab, der angibt, ob Zeichen überprüft werden sollen, oder legt diesen fest.
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, wenn Zeichen überprüft werden sollen, andernfalls false. Der Standardwert ist true.
Hinweise
Diese Eigenschaft weist den XML-Reader an, Zeichen in den gelesenen XML-Daten zu überprüfen und auszulösen XmlException , wenn Zeichen außerhalb des Bereichs der zulässigen XML-Zeichen liegen. Bei aktivierter Zeichenüberprüfung ist Folgendes sichergestellt:
Zeichen befinden sich innerhalb des Bereichs der gesetzlichen 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 truefestgelegt ist, was die Standardeinstellung ist, wird eine XmlException Ausnahme ausgelöst, wenn die XML-Datei ungültige Zeichen oder ungültige XML-Namen enthält (z. B. beginnt ein Elementname mit einer Zahl).
Wenn der XmlReader Textdaten verarbeitet, überprüft er unabhängig von der Eigenschafteneinstellung stets, ob die XML-Namen und der Textinhalt gültig sind. Durch Festlegen von CheckCharacters auf false wird die Zeichenüberprüfung für Zeichenentitätsverweise deaktiviert.
