XmlValidatingReader.EntityHandling Propriedade
Definição
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 lida com 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 da propriedade
Um dos EntityHandling valores. Se não EntityHandling for especificado, ele usará o padrão EntityHandling.ExpandEntities.
Exceções
O valor inválido foi especificado.
Comentários
Observação
A XmlValidatingReader classe está obsoleta no .NET Framework 2.0. Você 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 de Comentários da página de referência XmlReader.
Essa propriedade pode ser alterada 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 dos 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ó do elemento "doc" contém um nó de texto com o texto de entidade expandido:
| Profundidade | NodeType | Nome | Valor |
|---|---|---|---|
| 1 | Texto | Um 123 |
Quando EntityHandling é definido como ExpandCharEntities, e WhitespaceHandling é definido como Significant ou All, o elemento "doc" expande a entidade de caractere e retorna a entidade geral como um nó:
| Profundidade | NodeType | Nome | Valor |
|---|---|---|---|
| 1 | Texto | Um | |
| 1 | EntityReference | num | |
| 1 | SignificantWhitespace |
