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 / Funciones HFSQL
  • Gestión de los identificadores de automatic
  • Escribir registros borrados o cruzados
  • La versión del archivo de datos después de una operación de escritura
  • Gestión de memos binarios
  • Si utiliza HWrite con una base de datos Hyper File 5.5
  • Navegando y escribiendo un 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
Escribe un Record en un archivo de datos sin actualizar los índices correspondientes a todas las claves utilizadas en el archivo de datos. Los memos se añaden si es necesario (si la gestión de memos está activada, HSetMemo).
Después de la llamada a HWrite:
  • no se comprueba la integridad ni los errores de duplicación.
  • si se produce un problema de bloqueo (intentar modificar un registro bloqueado), la función HErrorLock devuelve True y el registro no se modifica.
  • se modifica el número del actual Record: el actual Record corresponde al Record escrito.
Observaciones:
  • Para actualizar los índices durante una operación de escritura, utilice HAdd o HModify.
    OLE DBConectores Nativos La función HWrite es equivalente a la función HModify. Los índices de la base de datos se actualizan.
  • Si se modifica el valor de una clave con la función HWrite, el índice se desincronizará. Hay que reindexar (HIndex).
  • Esta función se puede utilizar para escribir un registro en una selección realizada por una consulta (consulta ejecutada con la constante hWithFilter).
Ejemplo
// Write a record at the end of a data file
HWrite(Customer, HNbRec() + 1)
Sintaxis
<Result> = HWrite([<Data file> [, <Record number> [, <Options>]]])
<Result>: booleano
  • True si la escritura se realizó en el archivo de datos ,
  • False si se produce un error (bloqueo, etc.): el Record no se modifica. La función HError permite identificar el error.
<Data file>: Cadena de caracteres opcional
Nombre del archivo de datos utilizado. Si no se especifica este nombre, la función HWrite utilizará el último archivo de datos utilizado por la última función HFSQL (que empieza por "H").
<Record number>: Entero opcional
Número de la Record a escribir. El Record cargado en la memoria se reescribe en el Record especificado.
Si este número es mayor que el número total de registros en el archivo de datos, se crearán registros intermedios borrados para que la lectura secuencial del archivo de datos (HRead) sea coherente.
Si no se especifica este parámetro (igual a 0 o a la constante hCurrentRecNum ), HWrite modifica el actual Record en el archivo de datos.
OLE DBConectores Nativos La función HWrite solo modifica el registro actual. No puede especificar un número Record que no sea el actual (para especificar el número Record actual, utilice la constante hRecNumCurrent ).
<Options>: Combinación de constantes opcionales
Configura:
  • el modo para calcular el identificador automatic: Para más detalles sobre los identificadores automatic para los nuevos registros, véase Gestión del identificador automático al agregar un registro.
    hForceIdAutoEl identificador de automatic no se calcula durante la operación de escritura: El valor del identificador es el que se almacena durante la operación de escritura.
    hRecalculateIdAutoEl identificador automático del Record será recalculado durante la operación de escritura. Esta constante tiene prioridad sobre las constantes hForceIdAuto y hSetIdAuto.
    hSetIdAutoEl identificador de automatic no se calcula durante la operación de escritura: El valor del identificador es el que se almacena durante la operación de escritura..
    El siguiente valor del identificador calculado por el motor HFSQL corresponderá al valor más grande del identificador en el archivo +1.
    hWriteDefault
    (Valor predeterminado)
    Si el Record escrito no es un Record eliminado , el identificador automático (si existe) del Record en el archivo de datos se reutiliza.
    Si el Record escrito es un Record eliminado , se calcula un nuevo identificador automático para el Record.
    La constante hWriteDefault se ignora si se especifica con una de las otras constantes.

    Si se utilizan las tres constantes al mismo tiempo (hForceIdAuto, hSetIdAuto y hRecalculateIdAuto) se produce un error WLanguage.
  • el modo de bloqueo aplicado al Record .
    Si no se especifica una constante de bloqueo, la Record no está bloqueada.
    hLockNo
    (Valor predeterminado)
    Sin bloqeuo: el escrito Record no está bloqueado.
    hLockReadWriteBloqueo de lectura y escritura: la Record escrita será bloqueada en lectura/escritura. Este registro no puede ser leído ni modificado por otras aplicaciones. Solo la aplicación actual puede modificarlo, leerlo o desbloquearlo.
    hLockWriteBloqueo de escritura: el Record escrito se bloqueará en modo de escritura. Otras aplicaciones pueden leer el registro pero no modificarlo. Solo la aplicación en curso podrá modificarlo o desbloquearlo.

OLE DBConectores Nativos Las opciones de bloqueo no tendrán efecto si el proveedor de OLE DB o Conector Nativo (también llamado Native Access) no admite bloqueos.

Hyper File 5.5 es ignorada.
Observaciones

Gestión de los identificadores de automatic

Por defecto, el elemento "identificador automático" se actualiza automáticamente cuando se añade una Record en un archivo de datos.
Las constantes hForceIdAuto y hSetIdAuto permiten modificar el comportamiento predeterminado del identificador automático.
Para más detalles sobre los identificadores automatic para los nuevos registros, véase Manejo del identificador automatic.

OLE DBConectores Nativos Casos especiales
  • Si la base de datos genera un identificador automatic, el motor HFSQL mantiene este valor. Si se especifica la constante hForceIDAuto o hSetIDAuto , el motor HFSQL reemplaza el valor generado por el valor deseado.
    Observación: la constante hForceIdAuto equivale a hSetIdAuto: el identificador automatic calculado por el motor HFSQL durante la próxima adición será único en el archivo de datos.
  • Si la base de datos no genera ningún identificador de automatic, el motor HFSQL genera el valor y lo asigna al identificador automatic.
WINDEVUniversal Windows 10 AppLenguaje ExternoHFSQL ClassicHFSQL Client/ServerHyper File 5.5

Escribir registros borrados o cruzados

Si el número Record corresponde a un Record cruzado o a un Record borrado, este Record se vuelve a activar.
WINDEVUniversal Windows 10 AppLenguaje ExternoHFSQL ClassicHFSQL Client/ServerHyper File 5.5

La versión del archivo de datos después de una operación de escritura

Si el Record fue escrito (sin problemas de bloqueo, etc.), el número de versión de el archivo de datos es modificado. Para get el número de versión, utilice HVersion.

Gestión de memos binarios

Cuando se modifica una Record, se modifican los memos si es necesario (si la gestión de los memos está habilitada por HSetMemo).
Recordatorio: para inicializar un elemento de memoria binario, utilice HLinkMemo.
WINDEVLenguaje ExternoHyper File 5.5

Si utiliza HWrite con una base de datos Hyper File 5.5

Los elementos TEXT se rellenan automáticamente con caracteres de espacio.
WINDEVConectores Nativos

Navegando y escribiendo un Record

Si la operación de escritura se realiza durante una búsqueda, el Record escrito será Visible en la búsqueda actual solamente. Si se han definido otras operaciones de navegación en esta base de datos, el Record escrito sólo será Visible una vez que estas operaciones de navegación se hayan reiniciado.
Componente: wd290hf.dll
Versión mínima requerida
  • Versión 9
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 20/04/2023

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