XmlTextReader.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, por defeito passa a EntityHandling.ExpandCharEntities.
Observações
Note
Recomendamos que crie instâncias XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.
Esta propriedade pode ser alterada em tempo real 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 | Tipo de nó | Name | Value |
|---|---|---|---|
| 1 | Text |
A 123 |
Quando EntityHandling está definido como ExpandCharEntities, e WhitespaceHandling está definido como Significant ou All, o elemento "doc" expande a entidade do carácter e devolve a entidade geral como nó:
| Profundidade | Tipo de nó | Name | Value |
|---|---|---|---|
| 1 | Text |
A | |
| 1 | EntityReference |
número | |
| 1 | SignificantWhitespace |
