HTransactionLibère (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Cas particuliers
Manipulations d'enregistrements pendant une transaction
Transactions et contexte HFSQL indépendant

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

HTransactionLibère (Fonction)

En anglais : HTransactionFree

Disponible uniquement avec ces types de connexion

Transforme tous les enregistrements "en transaction" en enregistrements "Normaux" si ces enregistrements n'appartiennent pas à une transaction actuellement en cours. Si un enregistrement du fichier de données spécifié est considéré comme étant en transaction, mais n'appartient à aucune transaction en cours, il est automatiquement libéré.

Attention : cette fonction est une fonction avancée. Cette fonction doit être utilisée lorsqu'il est impossible d'annuler les transactions qui ont échoué (fichiers de transaction supprimés par exemple).

Versions 17 et supérieures

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Nouveauté 17

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Versions 18 et supérieures

Cette fonction est désormais disponible en mode Windows Store apps.

Cette fonction est désormais disponible pour les applications Java.

Cette fonction est désormais disponible pour les applications Android.

Nouveauté 18

Cette fonction est désormais disponible en mode Windows Store apps.

Cette fonction est désormais disponible pour les applications Java.

Cette fonction est désormais disponible pour les applications Android.

Cette fonction est désormais disponible en mode Windows Store apps.

Cette fonction est désormais disponible pour les applications Java.

Cette fonction est désormais disponible pour les applications Android.

Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.

Versions 21 et supérieures

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Cette fonction est désormais disponible pour libérer les transactions sur les fichiers de données d'un cluster HFSQL.

Nouveauté 21

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Cette fonction est désormais disponible pour libérer les transactions sur les fichiers de données d'un cluster HFSQL.

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Cette fonction est désormais disponible pour libérer les transactions sur les fichiers de données d'un cluster HFSQL.

Exemple

// Libère tous les enregistrements en transaction susceptibles d'être utilisés
HTransactionLibère(Client)

Syntaxe

Libération d'un fichier de données Masquer les détails

<Résultat> = HTransactionLibère([<Fichier de données>])

<Résultat> : Booléen

Vrai si l'opération est effectuée,
Faux en cas de problème. La fonction HErreurInfo permet d'obtenir plus de renseignements sur l'erreur.

<Fichier de données> : Chaîne de caractères (avec guillemets) optionnelle

Nom du fichier de données HFSQL Classic ou Client/Serveur pour lequel les enregistrements en cours de transaction doivent être libérés.
Si ce paramètre n'est pas spécifié, la fonction HTransactionLibère manipule le dernier fichier de données utilisé.

Seuls les fichiers de données HFSQL Client/Serveur peuvent être manipulés.

Libération d'un enregistrement d'un fichier de données Masquer les détails

<Résultat> = HTransactionLibère([<Fichier de données>, ] <Numéro de l'enregistrement>)

<Résultat> : Booléen

Vrai si l'opération est effectuée,
Faux en cas de problème. La fonction HErreurInfo permet d'obtenir plus de renseignements sur l'erreur.

<Fichier de données> : Chaîne de caractères (avec guillemets) optionnelle

Nom du fichier de données HFSQL Classic ou Client/Serveur pour lequel l'enregistrement en cours de transaction doit être libéré.
Si ce paramètre n'est pas spécifié, la fonction HTransactionLibère manipule le dernier fichier de données utilisé.
Seuls les fichiers de données HFSQL Client/Serveur peuvent être manipulés.

<Numéro de l'enregistrement> : Entier

Numéro de l'enregistrement à libérer.
Si ce paramètre est égal à 0 ou à la constante hNumEnrEnCours, la fonction HTransactionLibère va manipuler l'enregistrement en cours.

Remarques

Cas particuliers

Cette fonction peut être utilisée uniquement pour des fichiers de données au format HFSQL. Pour tous les autres types de fichier de données, cette fonction est sans effet et renvoie Vrai.
Les enregistrements ne pouvant pas être lus (enregistrements bloqués par exemple) sont ignorés.
Cette fonction peut être utilisée uniquement avec des fichiers de données HFSQL Client/Serveur.
La gestion des transactions est disponible uniquement pour les bases de données HFSQL Client/Serveur.
Versions 21 et supérieures
Cette fonction peut être utilisée pour libérer les transactions effectuées sur des fichiers de données présents dans un cluster HFSQL.
Nouveauté 21
Cette fonction peut être utilisée pour libérer les transactions effectuées sur des fichiers de données présents dans un cluster HFSQL.
Cette fonction peut être utilisée pour libérer les transactions effectuées sur des fichiers de données présents dans un cluster HFSQL.

Manipulations d'enregistrements pendant une transaction

Pendant une transaction, il est nécessaire de suivre certaines règles lors de la manipulation des enregistrements. Pour plus de détails, consultez Transactions : Manipuler les enregistrements lors d'une transaction.

Transactions et contexte HFSQL indépendant

Lors de la copie de contexte, si une transaction est en cours sur le premier contexte, le nouveau contexte n'est pas en transaction. Il faut rappeler la fonction HTransactionDébut (ou la fonction HTransaction) pour démarrer une transaction dans le nouveau contexte.

Composante : wd260hf.dll

Voir Aussi

Version minimum requise

Version 9

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 21/10/2020

Signaler une erreur ou faire une suggestion | Aide en ligne locale