Compartir a través de


Crear nuevas referencias de entidad

El método CreateEntityReference crea un nuevo nodo XmlEntityReference . El modelo de objetos de documento XML (DOM) busca ver si ya se ha declarado el nombre de entidad al que se hace referencia. Si lo tiene, los nodos secundarios del nodo XmlEntityReference se copian del nodo de declaración de entidad. Si no hay ninguna declaración de entidad que coincida, se adjunta un nodo de texto vacío como el único elemento secundario del nodo de referencia de entidad. Dado que los nodos secundarios del nodo XmlEntityReference son copias de otros nodos, estos nodos secundarios son de solo lectura y no se pueden modificar.

Al copiar los nodos, puede haber un espacio de nombres en el punto de la referencia de entidad. Este espacio de nombres afecta a la configuración de cualquier elemento o nodos de atributo generados.

Nota:

El DOM agrega nodos secundarios a EntityReference solo cuando se inserta el nodo EntityReference en el documento. Los nodos EntityReference recién creados no tienen nodos secundarios.

Aunque XmlDataDocument es una clase derivada de XmlDocument, XmlDataDocument no admite la creación de referencias de entidad. Esto es debido a que los nodos secundarios de EntityReference son de solo lectura. Los hijos de un nodo EntityReference pueden abarcar más de una región. En este caso, parte de una fila asociada a la región que contiene una parte de entityReference será de solo lectura.

Consulte también