XmlReaderSettings.CheckCharacters Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define um valor que indica se deve fazer verificação 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 Propriedade
true fazer verificação de carácter; caso contrário false. A predefinição é true.
Observações
Esta propriedade instrui o leitor de XML a verificar os caracteres nos dados XML que está a ler e a lançar uma verificação XmlException se algum carácter estiver fora do alcance dos caracteres XML legais. Quando a verificação de caracteres está ativada, garante-se o seguinte:
Os caracteres estão dentro do intervalo dos caracteres XML legais, conforme definido pela secção de 2.2 Caracteres da Recomendação XML 1.0 do W3C.
Todos os nomes XML são válidos, conforme definido na secção 2.3 Common Syntactic Constructs da Recomendação XML 1.0 do W3C.
Quando esta propriedade é definida para true, que é a definição padrão, é lançada uma XmlException exceção se o ficheiro XML contiver caracteres ilegais ou nomes XML inválidos (por exemplo, um nome de elemento começa por um número).
Se for XmlReader for a processar dados de texto, verifica sempre se os nomes XML e o conteúdo do texto são válidos, independentemente da configuração da propriedade. Ao definir CheckCharacters para false, desliga-se a verificação de entidades de referência de caracteres.