XmlTextReader.EntityHandling Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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, setPublic Property EntityHandling As EntityHandlingValor 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> A # </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 |
