Este método permite seleccionar el elemento especificado de una matriz de tipo XmlItems. A partir del elemento seleccionado, podrán ejecutarse otros métodos.
El elemento se especifica mediante una expresión XPath. Si la expresión XPath coincide con varios elementos, se seleccionará el primer elemento coincidente. Si se asigna una cadena nula a la entrada i_sXpathToElement, se seleccionará el elemento raíz.
Con cada llamada, se iniciará una búsqueda del elemento especificado desde el principio de la matriz. Es decir, el uso de la misma expresión XPath siempre conllevará la selección del mismo elemento.
El valor de retorno de tipo BOOL indicará TRUE si se ha seleccionado correctamente un elemento.
Las llamadas de este método devolverán Ok, XPathExpressionInvalid o ElementNotFound. Utilice la propiedad Result para obtener el resultado del método.
|
Entrada |
Tipo de datos |
Descripción |
|---|---|---|
|
i_sXpathToElement |
STRING[255] |
Expresión XPath para especificar el elemento que se va a seleccionar. Si se asigna una cadena nula, se seleccionará el elemento raíz. |
|
i_refXmlItems |
REFERENCE TO XmlItems |
Matriz proporcionada por la aplicación que contiene los elementos y atributos que se leen de un archivo XML o que se van a escribir en él. |
Utilice la sintaxis del lenguaje XPath (XML Path) para especificar el elemento que se va a seleccionar.
La tabla contiene una lista de las expresiones XPath admitidas:
|
Expresión XPath |
Descripción |
|---|---|
|
/…/<Nombre del elemento> |
Selecciona el primer elemento que coincide con la ruta especificada. |
|
/…/<Nombre del elemento>[<n>] |
Selecciona el enésimo elemento que coincide con la ruta especificada. |
|
/…/<Nombre del elemento>[@<Atributo>] |
Selecciona el primer elemento que coincide con la ruta especificada y que contiene el atributo especificado. |
|
/…/<Nombre del elemento>[@<Atributo>=<Valor>] |
Selecciona el primer elemento que coincide con la ruta especificada y que contiene el atributo y valor especificados. |
Los predicados (las expresiones entre corchetes []), pueden ir seguidos de una barra inclinada / junto con un nombre de elemento para la dirección al siguiente elemento hijo.
Ejemplo: /…/<Nombre del elemento>[<n>]/<Nombre del elemento>
Condición previa: El archivo XML (ilustrado a continuación) se ha leído mediante FB_XmlRead y el contenido se ha almacenado en la matriz astXmlFile de tipo XmlItems.
|
Código: fbXmlItems.SelectElement('/root/A1', astXmlData); Resultado: Se selecciona el elemento A1. |
|
