Comparteix a través de


XmlTextReader.EntityHandling Propiedad

Definición

Obtiene o establece un valor que especifica cómo controla el lector las 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 de propiedad

Uno de los valores de EntityHandling. Si no se especifica ningún valor para EntityHandling, el valor predeterminado es EntityHandling.ExpandCharEntities.

Comentarios

Nota

A partir de .NET Framework 2.0, se recomienda crear XmlReader instancias mediante el XmlReader.Create método para aprovechar las nuevas funcionalidades.

Esta propiedad se puede cambiar sobre la marcha y surte efecto después de la siguiente Read llamada.

Cuando EntityHandling se establece ExpandCharEntitiesen , los valores de atributo solo se normalizan parcialmente. El lector normaliza cada nodo de texto individual independientemente del contenido de los nodos de referencia de entidad adyacentes.

Para ilustrar la diferencia entre los modos de control de entidades, tenga en cuenta el siguiente XML:

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

Cuando EntityHandling se establece ExpandEntities en el nodo de elemento "doc" contiene un nodo de texto con el texto de entidad expandido:

Profundidad Tipo de nodo Nombre Value
1 Text A 123

Cuando EntityHandling se establece ExpandCharEntitiesen y WhitespaceHandling se establece Significant en o All, el elemento "doc" expande la entidad de caracteres y devuelve la entidad general como nodo:

Profundidad Tipo de nodo Nombre Value
1 Text A
1 EntityReference num
1 SignificantWhitespace

Se aplica a

Consulte también