AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Administrar bases de datos / HFSQL / Tipos de variables HFSQL
  • Declarando un Record Variable
  • Acceso a los artículos
  • Lectura y asignación de un Record Variable
  • Casos especiales
  • Funciones que manipular el tipo Record
  • Propiedades específicas de las variables Record
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
El tipo Record permite manipular (modificar, guardar, etc.) los valores de un registro. Este Record puede ser un Record que se encuentra en un archivo de datos, una consulta o una vista. La variable asociada al tipo Record se estructurará como un registro de la base de datos.
Ejemplos de uso: Esto le permite almacenar en diferentes variables el contenido de varios registros para compararlos o para comparar algunos artículos..
Ejemplo
// CUSTOMER is a data file described in the analysis
CustomerRec is Record of CUSTOMER
 
HReadFirst(CUSTOMER, CUSTNUM)
IF NOT HOut() THEN
CustomerRec = CUSTOMER
// Display the last and first names of the customer
Info(CustomerRec.LASTNAME, CustomerRec.FIRSTNAME)
END
// CUSTOMER is a data file described in the analysis
CustomerRec is Record of CUSTOMER
 
CustomerRec.LastName = "MOORE"
CustomerRec.FirstName = "Paul"
CustomerRec.City = "PARIS"
 
// Assigns the content of the CustomerRec variable in the buffer of Customer data file
CUSTOMER = CustomerRec  
 
HAdd(CUSTOMER)
 
// You have the ability to do: HAdd(CUSTOMER, CustomerRec)
Observaciones

Declarando un Record Variable

La siguiente sintaxis se utiliza para declarar una variable de tipo Record:
<Variable name> is Record [of <Name of data file in the analysis>]
  • Si se especifica <Nombre del archivo de datos en el análisis>, el Record se asocia a un description de uno de los archivos de datos en el análisis. En este caso, tienes la capacidad de manipular los diferentes artículos de Record.
  • Si no se especifica <Nombre del fichero de datos en el análisis>, la estructura del Record se construirá dinámicamente según el buffer del fichero que se le asigne.

Acceso a los artículos

Para acceder a los elementos de un Record Variable, utilice la siguiente sintaxis:
  • Para asignar un elemento de la Variable:
    <Variable name>.<Item name> = <Value to assign>
  • Para recuperar el valor de los elementos:
    <Value> = <Variable name>.<Item name>
Observación: Cuando se utiliza una variable Record asociada a un archivo de datos del análisis, el editor de código propone automáticamente los diferentes elementos de Record:

Lectura y asignación de un Record Variable

Las variables de tipo Record se pueden leer o asignar. La sintaxis es la siguiente:
  • Para almacenar el buffer de un archivo de datos en un Record Variable LE:
    <Name of Record variable> = <Name of data file>
  • Para asignar el buffer de un archivo de datos de un Record Variable LE:
    <Name of data file> = <Name of Record variable>
Observación: La asignación de una variable de tipo Record a un archivo de datos modifica el NewRecord Property.

Casos especiales

  • HRecordToString utilizado en un Record Variable devuelve una cadena de caracteres que contiene el valor de cada elemento separado por un carácter TAB.
  • No se produce ningún error de compilación si un Record Variable con tipo en un archivo de datos se asigna con el búfer de otro archivo de datos. Se realiza un copy homónimo de los buffers: sólo se asignarán los elementos con el mismo nombre de cada búfer. Los demás elementos no se asignarán.
  • Para este tipo de Variable (serialize) sólo está disponible la serialización JSON. No es posible la deserialización.

Funciones que manipular el tipo Record

Las siguientes funciones utilizan el tipo Record:
HAddAgrega:
  • el registro que se encuentra en la memoria al archivo de datos (consulta o vista).
  • el registro que se encuentra en una variable de tipo Record al archivo de datos (consulta o vista).
HCopyRecordCopia:
  • el contenido del registro en curso (cargado en memoria) en el registro en curso de un archivo de datos.
  • el contenido de una variable de tipo Record en el registro en curso de un archivo de datos
HExtractMemoExtrae el contenido de un campo de tipo memo binario de un archivo de datos, consulta o vista HFSQL a un archivo físico (en el disco).
HInfoMemoDevuelve las características de un memo binario y de texto.
HLinkMemoPermite asociar un archivo a un campo de tipo memo binario o cancelar la asociación existente entre un archivo y un campo binario.
HListItemDevuelve la lista de artículos:
  • encontrado en un archivo de datos ( una consulta o una vista) conocido por el motor HFSQL. Los archivos de datos definidos por las funciones HDeclare, HDeclareExternal y HDescribeFile se tienen en cuenta.
  • encontrada en un Record Variable.
HRecordToStringConvierte el contenido de la Record actual en cadena (en un archivo de datos, vista HFSQL, consulta, etc.).
HResetInicializa:
  • una o todas las variables de los elementos de un archivo de datos con sus valores predeterminados.
  • uno o todos los elementos de una variable de tipo Record con sus valores predeterminados.
Observación: También puede utilizar VariableReset para restablecer el contenido de una variable de tipo Record.

Propiedades específicas de las variables Record

Las siguientes propiedades pueden utilizarse para averiguar las características de un Record Variable:
Nombre de la propiedadTipo utilizadoEfecto
AssociatedFileCadena de caracteresNombre del archivo de datos HFSQL en el que se basa el Variable.
Esta propiedad es de solo lectura.
ContenidoCadena de caracteresContenido de la Record actual (idéntico al resultado devuelto por HRecordToString).
Esta propiedad es de solo lectura.
Versión mínima requerida
  • Versión 19
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 28/01/2023

Señalar un error o enviar una sugerencia | Ayuda local