XmlTextReader.EntityHandling Propriedade

Definição

Obtém ou define um valor que especifica como o leitor trata entidades.

public System.Xml.EntityHandling EntityHandling { get; set; }

Valor da propriedade

EntityHandling

Um dos valores de EntityHandling. Se nenhum EntityHandling for especificado, ele usará EntityHandling.ExpandCharEntities como padrão.

Comentários

Observação

A partir do .NET Framework 2.0, recomendamos que você crie XmlReader instâncias usando o XmlReader.Create método para aproveitar a nova funcionalidade.

Essa propriedade pode ser alterada em tempo real e entra em vigor após a próxima Read chamada.

Quando EntityHandling é definido como ExpandCharEntities, os valores de atributo são apenas parcialmente normalizados. O leitor normaliza cada nó de texto individual independentemente do conteúdo de nós de referência de entidade adjacentes.

Para ilustrar a diferença entre os modos de tratamento de entidade, considere o seguinte XML:

<!DOCTYPE doc [<!ENTITY num "123">]>  
    <doc> &#65; &num; </doc>  

Quando EntityHandling é definido como ExpandEntities o nó de elemento "doc" contém um nó de texto com o texto da entidade expandido:

Profundidade Tipo de nó Nome Valor
1 Text Um 123

Quando EntityHandling é definido como ExpandCharEntities, e WhitespaceHandling é definido Significant como ou All, o elemento "doc" expande a entidade de caractere e retorna a entidade geral como um nó:

Profundidade Tipo de nó Nome Valor
1 Text Um
1 EntityReference num
1 SignificantWhitespace

Aplica-se a

Confira também