XmlReaderSettings.CheckCharacters Vlastnost

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlReaderSettings.cs

Získá nebo nastaví hodnotu označující, zda provést kontrolu znaků.

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

Hodnota vlastnosti

Boolean

true provádět kontrolu znaků; jinak false. Výchozí hodnota je true.

Poznámky

Tato vlastnost dává čtečce XML pokyn, aby zkontroloval znaky v datech XML, která čte, a vyvolá XmlException , pokud některé znaky nejsou mimo rozsah právních znaků XML. Pokud je povolená kontrola znaků, máte zajištěno následující:

• Znaky jsou v rozsahu právních znaků XML, jak je definováno oddílem 2,2 Znaků v doporučení W3C XML 1.0.

• Všechny názvy XML jsou platné, jak je definováno oddílem 2.3 Common Syntactic Constructs v doporučení W3C XML 1.0.

Pokud je tato vlastnost nastavena na true, což je výchozí nastavení, vyvolá se výjimka, XmlException pokud soubor XML obsahuje neplatné znaky nebo neplatné názvy XML (například název elementu začíná číslem).

XmlReader Pokud zpracovává textová data, vždy zkontroluje, zda jsou názvy XML a textový obsah platné bez ohledu na nastavení vlastnosti. Nastavením CheckCharacters na false se vypne kontrola znaků u odkazů na znakové entity.