XmlReaderSettings.CheckCharacters Eigenschaft

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Source:

XmlReaderSettings.cs

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

Boolean

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.