XmlReaderSettings.CheckCharacters Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia wartość wskazującą, czy należy sprawdzić znaki.
public:
property bool CheckCharacters { bool get(); void set(bool value); };public bool CheckCharacters { get; set; }member this.CheckCharacters : bool with get, setPublic Property CheckCharacters As BooleanWartość właściwości
true do sprawdzania znaków; w przeciwnym razie false. Wartość domyślna to true.
Uwagi
Ta właściwość instruuje czytelnika XML, aby sprawdzał znaki w danych XML, które odczytuje i zgłasza, XmlException jeśli jakiekolwiek znaki znajdują się poza zakresem znaków prawnych XML. Po włączeniu sprawdzania znaków upewnij się, że są spełnione następujące kwestie:
Znaki znajdują się w zakresie znaków PRAWNYCH XML, zgodnie z definicją sekcji 2.2 Znaki zalecenia W3C XML 1.0.
Wszystkie nazwy XML są prawidłowe, zgodnie z definicją w sekcji Common Syntactic Constructs (Typowe konstrukcje syntatyczne ) zalecenia W3C XML 1.0.
Gdy ta właściwość jest ustawiona na truewartość , która jest ustawieniem domyślnym, zgłaszany jest wyjątek, XmlException jeśli plik XML zawiera niedozwolone znaki lub nieprawidłowe nazwy XML (na przykład nazwa elementu zaczyna się od liczby).
Jeśli dane XmlReader tekstowe są przetwarzane, zawsze sprawdza, czy nazwy XML i zawartość tekstowa są prawidłowe, niezależnie od ustawienia właściwości. Ustawienie powoduje CheckCharacters false wyłączenie sprawdzania znaków dla odwołań do jednostki znaków.