XmlReaderSettings.CheckCharacters Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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.