XmlReaderSettings.CheckCharacters Propriedade
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
true
para fazer a verificação de caracteres de; caso contrário, false
. O padrão é true
.
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.
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 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: