XmlReaderSettings.CheckCharacters Propriedade

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Origem:

XmlReaderSettings.cs

Obtém ou define um valor que indica se a verificação de caracteres deve ser feita ou não.

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 da propriedade

Boolean

true para fazer a verificação de caracteres de; caso contrário, false. O padrão é true.

Comentários

Essa propriedade instrui o leitor XML a verificar caracteres nos dados XML que está lendo e gerar um XmlException se algum caractere estiver fora do intervalo de caracteres XML legais. Quando a verificação de caractere é ativado, você está assegurado o seguinte:

• Os caracteres estão dentro do intervalo de caracteres XML legais, conforme definido pela seção 2.2 Caracteres da Recomendação W3C XML 1.0.

• Todos os nomes XML são válidos, conforme definido pela seção 2.3 Common Syntactic Constructs da Recomendação W3C XML 1.0.

Quando essa propriedade é definida como true, que é a configuração padrão, uma exceção XmlException é gerada se o arquivo XML contiver caracteres ilegais ou nomes XML inválidos (por exemplo, um nome de elemento começa com um número).

Se XmlReader estiver processando dados de texto, sempre verificará se os nomes XML e o conteúdo de texto são válidos, independentemente da configuração de propriedade. A definição de CheckCharacters como false desativa a verificação de caracteres em referências de entidade de caracteres.