XmlReaderSettings.CheckCharacters Propiedad

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

Source:

XmlReaderSettings.cs

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, set

Public Property CheckCharacters As Boolean

Valor de propiedad

Boolean

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.