XmlReaderSettings.CheckCharacters Eigenschap

Definitie

Hiermee wordt een waarde opgehaald of ingesteld waarmee wordt aangegeven of tekens moeten worden gecontroleerd.

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

Waarde van eigenschap

true om tekencontrole uit te voeren; anders false. De standaardwaarde is true.

Opmerkingen

Met deze eigenschap wordt de XML-lezer geïnstrueerd om tekens in de XML-gegevens te controleren die worden gelezen en genereert een XmlException als er tekens buiten het bereik van juridische XML-tekens vallen. Wanneer tekencontrole is ingeschakeld, controleert u het volgende:

  • Tekens vallen binnen het bereik van juridische XML-tekens, zoals gedefinieerd in de sectie 2.2 Tekens van de W3C XML 1.0-aanbeveling.

  • Alle XML-namen zijn geldig, zoals gedefinieerd in de sectie 2.3 Algemene Syntactische constructies van de W3C XML 1.0-aanbeveling.

Wanneer deze eigenschap is ingesteld op true, wat de standaardinstelling is, wordt er een XmlException uitzondering gegenereerd als het XML-bestand ongeldige tekens of ongeldige XML-namen bevat (bijvoorbeeld een elementnaam begint met een getal).

Als de XmlReader tekstgegevens worden verwerkt, wordt altijd gecontroleerd of de XML-namen en tekstinhoud geldig zijn, ongeacht de instelling van de eigenschap. Het instellen van CheckCharacters op false schakelt de controle op tekens voor tekenentiteitverwijzingen uit.

Van toepassing op