XmlValidatingReader.EntityHandling 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 especifica como o leitor gere as entidades.
public:
property System::Xml::EntityHandling EntityHandling { System::Xml::EntityHandling get(); void set(System::Xml::EntityHandling value); };public System.Xml.EntityHandling EntityHandling { get; set; }member this.EntityHandling : System.Xml.EntityHandling with get, setPublic Property EntityHandling As EntityHandlingValor de Propriedade
Um dos EntityHandling valores. Se não EntityHandling for especificado, passa por defeito a EntityHandling.ExpandEntities.
Exceções
Foi especificado o valor inválido.
Observações
Note
A classe XmlValidatingReader está obsoleta no .NET Framework 2.0. Pode criar uma instância de validação XmlReader usando a XmlReaderSettings classe e o Create método. Para obter mais informações, consulte a seção Comentários da XmlReader página de referência.
Esta propriedade pode ser alterada e entra em vigor após a próxima Read chamada.
Quando EntityHandling é definido para ExpandCharEntities, os valores dos atributos são apenas parcialmente normalizados. O leitor normaliza cada nó de texto individual independentemente do conteúdo dos nós de referência de entidades adjacentes.
Para ilustrar a diferença entre os modos de manipulação de entidades, considere o seguinte XML:
<!DOCTYPE doc [<!ENTITY num "123">]>
<doc> A # </doc>
Quando EntityHandling está definido para ExpandEntities o elemento "doc", o nó contém um nó de texto com o texto da entidade expandida:
| Profundidade | NodeType | Name | Value |
|---|---|---|---|
| 1 | Texto | A 123 |
Quando EntityHandling está definido como ExpandCharEntities, e WhitespaceHandling está definido como Significativo ou Todo, o elemento "doc" expande a entidade do carácter e devolve a entidade geral como nó:
| Profundidade | NodeType | Name | Value |
|---|---|---|---|
| 1 | Texto | A | |
| 1 | EntityReference | número | |
| 1 | Espaço branco significativo |
