|
|
|
|
- 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
HWrite (Función)
No disponible con este tipo de conexión
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.
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).
// 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.
<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.
| | hForceIdAuto | El 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. | hRecalculateIdAuto | El identificador automático del Record será recalculado durante la operación de escritura. Esta constante tiene prioridad sobre las constantes hForceIdAuto y hSetIdAuto. | hSetIdAuto | El 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. | hLockReadWrite | Bloqueo 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. | hLockWrite | Bloqueo 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. |
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. 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.
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|