XmlTextReader.EntityHandling 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 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
Um dos valores de EntityHandling. Se nenhum EntityHandling
for especificado, ele usará EntityHandling.ExpandCharEntities
como padrão.
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> A # </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 |