XmlTextReader.EntityHandling Propiedad

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

Source:

XmlTextReader.cs

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

EntityHandling

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

Consulte también

• XmlReader