XmlReaderSettings.CheckCharacters Właściwość

Definicja

Pobiera lub ustawia wartość wskazującą, czy sprawdzanie znaków ma być przeprowadzane.Gets or sets a value indicating whether to do character checking.

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

Wartość właściwości

Boolean

true do sprawdzania znaków; w przeciwnym razie false.true to do character checking; otherwise false. Wartość domyślna to true.The default is true.


Jeśli XmlReader przetwarza dane tekstowe, zawsze sprawdza, czy nazwy XML i zawartość tekstowa są prawidłowe, niezależnie od ustawienia właściwości.If the XmlReader is processing text data, it always checks that the XML names and text content are valid, regardless of the property setting. Ustawienie CheckCharacters na false wyłącza sprawdzanie znaków dla odwołań do jednostek znaków.Setting CheckCharacters to false turns off character checking for character entity references.

Uwagi

Ta właściwość nakazuje czytnikowi XML Sprawdzanie znaków w danych XML, które są odczytywane i zgłasza XmlException, jeśli wszystkie znaki są spoza zakresu dozwolonych znaków XML.This property instructs the XML reader to check characters in the XML data it's reading and throw an XmlException if any characters are outside the range of legal XML characters. Gdy sprawdzanie znaków jest włączone, należy wykonać następujące czynności:When character checking is enabled, you are ensured the following:

  • Znaki mieszczą się w zakresie dozwolonych znaków XML, jak zdefiniowano w sekcji 2,2 znaków zalecenia W3C XML 1,0.Characters are within the range of legal XML characters, as defined by the 2.2 Characters section of the W3C XML 1.0 Recommendation.

  • Wszystkie nazwy XML są prawidłowe, zgodnie z definicją w sekcji typowe konstrukcje składni 2,3 zalecenia dotyczącego W3C XML 1,0.All XML names are valid, as defined by the 2.3 Common Syntactic Constructs section of the W3C XML 1.0 Recommendation.

Gdy ta właściwość ma wartość true, która jest domyślnym ustawieniem, zostanie zgłoszony wyjątek XmlException, jeśli plik XML zawiera niedozwolone znaki lub nieprawidłowe nazwy XML (na przykład nazwa elementu zaczyna się od cyfry).When this property is set to true, which is the default setting, an XmlException exception is thrown if the XML file contains illegal characters or invalid XML names (for example, an element name starts with a number).

Dotyczy