Asigna información de cabecera a un valor.
Sintaxis
AssignHeader(Value, [ DataObject ] [ , ElementNames ])
La sintaxis de la función AssignHeader consta de los siguientes elementos:
Parte |
Descripción |
|---|---|
Value |
Es el valor al que debe asignarse la información de cabecera. Todas las estructuras de datos están permitidas. Se permiten todos los tipos de datos. |
DataObject |
Es una referencia a un objeto de datos cuya información de cabecera debe asignarse, o un valor con información de cabecera adjunta que debe asignarse. Si omite el argumento, se creará y asignará la información de cabecera que no esté vinculada a un objeto de datos. Si pasa como argumento DataObject una referencia a la fórmula en la que ejecuta la función AssignHeader, se tienen en cuenta los parámetros de la pestaña "Resultado" de dicha fórmula. Todas las estructuras de datos están permitidas. Se permiten todos los tipos de datos y referencias a objetos. |
ElementNames |
Es una lista cuyos nombres de elementos se utilizarán para formar los nombres de elementos del resultado. Este argumento solo se utiliza si ha especificado como argumento DataObject una referencia a la fórmula en la que ejecuta la función AssignHeader y cuya propiedad "Nombres de los elementos de lista tiene el valor "Automático". AssignHeader asigna entonces nombres a los elementos de la lista de resultados, que se forman a partir de los nombres de elementos de la lista transferida y de la configuración de la pestaña "Resultado" de la fórmula. El uso de AssignHeader con este argumento está obsoleto. Utilice en su lugar la variable local SourceData, como se muestra en los ejemplos siguientes. Todas las estructuras de datos están permitidas. Se permiten todos los tipos de datos y referencias a objetos. |
Notas
El resultado es el valor transferido al que se ha añadido o del que se ha eliminado la información de cabecera. Si Value es una lista, la información de cabecera se asigna a cada elemento de la lista. Si se nombra un elemento de lista, se crea una copia separada de la información de cabecera para él y se introduce el nombre del elemento de lista como atributo "Name".
Disponibilidad
FlexPro View, Basic, Professional, Developer Suite
Ejemplos
Result = AssignHeader(Result, This) |
Asigna la información de cabecera de la fórmula que contiene el código FPScript al valor "Result". |
Result = AssignHeader(Result, Formula As Object) |
Asigna la información de cabecera de la fórmula "Formula" al valor "Result". |
Result = AssignHeader(Result, Formula) |
Asigna al valor "Result" la información de cabecera adjunta al resultado de la fórmula "Formula". |
Result = AssignHeader(Result, $"\Data\Channel1"$) |
Asigna al valor "Result" la información de cabecera del conjunto de datos con el nombre de ruta especificado en la cadena. |
Result = AssignHeader(Integral(Data)) |
Asigna al valor "Result" información de cabecera que no está vinculada a un objeto de datos y, a continuación, asigna un nombre. |
Dim Data = [Signal1, Signal2] |
Calcula la integral de dos conjuntos de datos y transfiere el resultado en forma de lista. A cada elemento de la lista se le asigna una copia separada de la información de cabecera de la fórmula que contiene el código FPScript. Si se selecciona "Automático" en "Nombres de los elementos de lista" de la pestaña "Resultado" de la fórmula y se establece "Automático" como plantilla, el atributo "Name" se establece en "Signal1Integral" o "Signal2Integral". Esto significa que la expresión Result.[0].Name devolvería, por ejemplo, "Signal1Integral". |
Dim SourceData = [Signal1, Signal2] |
Este código es equivalente al ejemplo anterior y no requiere la función AssignHeader. Si asigna los datos de origen a la variable local SourceData, FlexPro puede acceder a los nombres de los elementos de los datos de origen después del cálculo y asignar automáticamente la información de cabecera. |