XmlReaderSettings.CheckCharacters Propriedade

Definição

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

public bool CheckCharacters { get; set; }

Valor da propriedade

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.

Aplica-se a

Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0