XmlReaderSettings.CheckCharacters Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece un valor que indica si se va a realizar la comprobación de caracteres.
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 BooleanValor de propiedad
Es true si se va a realizar la comprobación de caracteres; en caso contrario, es false. De manera predeterminada, es true.
Comentarios
Esta propiedad indica al lector XML que compruebe los caracteres de los datos XML que está leyendo y genere si XmlException hay caracteres fuera del intervalo de caracteres XML legales. Si habilita la comprobación de caracteres, tiene garantizado lo siguiente:
Los caracteres están dentro del intervalo de caracteres XML legales, tal y como se define en la sección 2.2 Caracteres de la recomendación W3C XML 1.0.
Todos los nombres XML son válidos, tal como se define en la sección Construcciones sintácticas comunes 2.3 de la recomendación W3C XML 1.0.
Cuando esta propiedad se establece trueen , que es la configuración predeterminada, se produce una XmlException excepción si el archivo XML contiene caracteres no válidos o nombres XML no válidos (por ejemplo, un nombre de elemento comienza con un número).
Si XmlReader procesa datos de texto, siempre comprueba que los nombres XML y el contenido de texto son válidos, independientemente de la configuración de la propiedad. Al establecer la propiedad CheckCharacters en false, se desactiva la comprobación de caracteres en las referencias a entidades de caracteres.
