XmlValidatingReader.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 EntityHandling valores. Si no se especifica, EntityHandling el valor predeterminado es EntityHandling.ExpandEntities.
Excepciones
Se especificó un valor no válido.
Comentarios
Nota:
La XmlValidatingReader clase está obsoleta en .NET Framework 2.0. Puede crear una instancia de validación XmlReader mediante la XmlReaderSettings clase y el Create método . Para obtener más información, vea la sección Comentarios de la página de referencia de XmlReader.
Esta propiedad se puede cambiar 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 en ExpandEntities el nodo del elemento "doc" contiene un nodo de texto con el texto de entidad expandido:
| Profundidad | NodeType | Nombre | Importancia |
|---|---|---|---|
| 1 | Text | A 123 |
Cuando EntityHandling se establece ExpandCharEntitiesen y WhitespaceHandling se establece en Significant o All, el elemento "doc" expande la entidad de caracteres y devuelve la entidad general como un nodo:
| Profundidad | NodeType | Nombre | Importancia |
|---|---|---|---|
| 1 | Text | A | |
| 1 | EntityReference | num | |
| 1 | SignificantWhitespace |
