FC_XmlSetElementValue Descripción funcional
|
Tipo: |
Bloque de funciones |
|
Disponible desde: |
V1.0.8.0 |
|
Hereda de: |
- |
|
Implementa: |
- |
La función FC_XmlSetElementValue se utiliza para modificar el valor del elemento XML especificado en el búfer de tipo XmlItems.
El valor de retorno es TRUE si la función se ha ejecutado correctamente. Si el valor de retorno es FALSE, evalúe la salida q_etResult.
|
Entrada |
Tipo de datos |
Descripción |
|---|---|---|
|
i_refXmlItems |
REFERENCE TO XmlItems |
Búfer proporcionado 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. |
|
i_sXpathToElement |
STRING[255] |
Expresión XPath que especifica el elemento que se va a leer. |
|
i_sElementValue |
STRING[Gc_uiXmlLengthOfString] |
Valor que se va a establecer para el elemento especificado. |
|
Salida |
Tipo de datos |
Descripción |
|---|---|---|
|
q_etResult |
ET_Result |
Proporciona información de diagnóstico en forma de valor numérico. |
Expresiones XPath que definen el contenido que se va a establecer
Utilice la sintaxis del lenguaje XPath (XML Path) para especificar el elemento cuyo valor se va a establecer. Las relaciones padre-hijo entre los elementos del búfer vienen determinadas por el parámetro diParentIndex que indica el índice de matriz en el que se almacena el elemento padre.
NOTA: La función FC_XmlSetElementValue admite un subconjunto de las funciones que se proporcionan con las expresiones XPath.
La tabla contiene una lista de las expresiones XPath admitidas:
|
Expresión XPath |
Descripción |
|---|---|
|
/…/<Nombre del elemento> |
Se selecciona el elemento con el nombre de nodo especificado. |
|
/…/<nombre_del_elemento>[<n>] |
Se selecciona el enésimo elemento con el nombre de nodo especificado. |
|
/…/<Nombre del elemento>[@<Atributo>] |
Selecciona el elemento con el nombre de nodo especificado que tiene el atributo especificado. |
|
/…/<Nombre del elemento>[@<Atributo>=<Valor>] |
Selecciona el elemento con el nombre de nodo especificado que tiene el atributo y el valor especificados. |
Los predicados, que son las expresiones entre corchetes [], pueden ir seguidos de una barra inclinada / junto con un nombre de elemento para direccionar el siguiente elemento hijo.
Ejemplo: /…/<Nombre del elemento>[<n>]/<Nombre del elemento>
