Freigeben über


XmlReaderSettings.CheckCharacters Eigenschaft

Definition

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, set
Public Property CheckCharacters As Boolean

Eigenschaftswert

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.

Gilt für: