DOMDocument
ImportNode
Disponible desde la versión 8.1.
Sintaxis:
ImportNode(<Nodo>, <Recursivamente>)
Parámetros:
<Nodo> (obligatorio)
Tipo: DOMAttribute, DOMDocument, DOMElement, DOMDocumentType, DOMNotation, DOMEntity, DOMDocumentFragment, DOMText, DOMComment, DOMCDATASection, DOMProcessingInstruction, DOMEntityReference, XPathNamespace.
Nodo DOM importado.
<Recursivamente> (obligatorio)
Tipo: Boolean.
Indicador de importación “profunda”. True – se importarán recursivamente todos los nodos hijos del nodo importado. Los siguientes nodos son una excepción: Attribute y EntityReference.
Los nodos hijos de Attribute siempre se importan, para EntityReference – los nodos hijos no se importan.
Si es False – solo se importa el nodo transferido.
Valor devuelto:
Tipo: DOMAttribute, DOMDocument, DOMElement, DOMDocumentType, DOMNotation, DOMEntity, DOMDocumentFragment, DOMText, DOMComment, DOMCDATASection, DOMProcessingInstruction, DOMEntityReference, XPathNamespace.
Valor importado del nodo DOM.
Descripción:
Importa un nodo de otro documento DOM.
Se importan el tipo de nodo y el nombre de nodo para cada nodo, así como las propiedades relacionadas con los espacios de nombres: LocalName, Prefix, NameSpaceURI. No se transfieren los datos de usuario.
Reglas de importación para los tipos de nodo:
- Attribute – OwnerElement se establece en Undefined, la bandera Specified se establece en True, se importan todos los nodos hijos;
- DocumentFragment – si se establece la bandera de importación “profunda”, entonces todos los hijos del fragmento se copian recursivamente al nuevo fragmento, de lo contrario se crea un nodo vacío DocumentFragment
- Document – no se puede importar;
- DocumentType – no se puede importar;
- Element – se importan los atributos con una propiedad establecida Specified, para el nuevo nodo-elemento se crean atributos con valores predeterminados;
- Entity – los nodos se pueden importar incluso si el documento es “solo lectura”. Se copian las propiedades PublicId, SystemId y NotationName;
- EntityReference – solo se importa este nodo. Si se define una entidad con el mismo nombre en este documento, entonces se forma un valor de entidad para la referencia importada;
- Notation – los nodos se pueden importar incluso si el documento es “solo lectura”. Se copian las propiedades PublicId, SystemId;
- ProcessingInstruction – se copian las propiedades Target y Data;
- Text, CDATASection, Comment – se copian las propiedades DOMText.Data, DOMComment.Data, DOMCDATASection.Data y DOMText.Length, DOMComment.Length, DOMCDATASection.Length.
Disponibilidad:
Servidor, cliente grueso, conexión externa, aplicación móvil (servidor), servidor independiente móvil.
Nota:
Razones de llamada de excepción:
- Los nombres importados contienen caracteres no válidos para el estándar XML de este documento.
Disponible desde:
Disponible desde la versión 8.1.
