XmlTextReader.EntityHandling Propriedade

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Obtém ou define um valor que especifica como o leitor trata 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, set

Public Property EntityHandling As EntityHandling

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

Confira também

• XmlReader