DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Annuler l'attachement existant
  • Différence entre les fonctions BinaireCharge et HAttacheMémo
  • Vignettes HFSQL
  • Gestion des mémos sous SQLite
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Permet d'associer un fichier à une rubrique de type mémo binaire ou d'annuler l'attachement existant entre un fichier et une rubrique binaire.
Le fichier sera lu et ajouté au mémo uniquement lors de l'ajout ou de la modification de l'enregistrement (fonction HAjoute, HModifie ou HEcrit). Si le fichier est ouvert en écriture et si la constante hAccepteFichierOuvert n'a pas été utilisée, la fonction renverra une erreur.
La fonction HExtraitMémo permettra d'extraire le fichier contenu dans le mémo sur le disque dur.
Remarque : Il est également possible d'utiliser l'affectation directe :
  • Pour associer directement une image (contenue dans un champ Image) à un mémo image :
    <NomFichier>.<NomRubriqueMémo> = <NomChampImage>

    Par exemple :
    UnFichier.UneRubriqueMémo = IMG_UnChampImage

    Cette syntaxe peut être utilisée aussi bien avec le moteur HFSQL qu'avec les Connecteurs Natifs.
    <NomFichier>.<NomRubriqueMémo> = <NomBuffer>

    Par exemple :
    bufFichier est un Buffer = fChargeBuffer("MonFichier")
    MonFichier.MonMémo = bufFichier
// Attache une image à l'enregistrement
HAttacheMémo(Produit, Image_Produit, "C:\Images\Produit1.gif", hMémoImg)
// Transfère le contenu des champs dans le buffer du fichier
EcranVersFichier()
// Ajoute l'enregistrement
HAjoute(Produit)
Syntaxe

Associer un fichier à une rubrique de type mémo binaire Masquer les détails

<Résultat> = HAttacheMémo(<Fichier de données> , <Rubrique> [, <Fichier à attacher> [, <Type> [, <Informations>]]])
<Résultat> : Booléen
  • Vrai si l'opération a été réalisée,
  • Faux en cas de problème. La fonction HErreur permet d'identifier l'erreur. Si le fichier à associer est ouvert en écriture et si la constante hAccepteFichierOuvert n'a pas été utilisée, la fonction renverra une erreur.
<Fichier de données> : Chaîne de caractères
Nom du fichier de données (ou de la requête) contenant une rubrique mémo.
Si seuls les paramètres <Fichier de données> et <Rubrique> sont précisés, la fonction HAttacheMémo annule l'attachement existant entre le fichier binaire et la rubrique.
<Rubrique> : Chaîne de caractères
Nom de la rubrique mémo du fichier de données dans laquelle le fichier binaire doit être ajouté.
Si seuls les paramètres <Fichier de données> et <Rubrique> sont précisés, la fonction HAttacheMémo annule l'attachement existant entre le fichier binaire et la rubrique.
<Fichier à attacher> : Chaîne de caractères optionnelle
Nom du fichier à associer à la rubrique de type mémo binaire. Ce nom peut correspondre :
  • soit au chemin complet du fichier à attacher,
  • soit au chemin relatif (par rapport au répertoire en cours) du fichier à attacher.
Si ce paramètre n'est pas précisé ou correspond à une chaîne vide (""), l'attachement en cours est supprimé.
AndroidWidget AndroidJava Si un chemin est spécifié, ce chemin doit correspondre à un fichier existant. Dans le cas contraire, une erreur fatale est affichée.
<Type> : Combinaison de constantes de type Entier, optionnelle
Indique le type du fichier à attacher et le mode de lecture du fichier.
hAccepteFichierOuvertAutorise la lecture du fichier source à ajouter dans le mémo si ce fichier source est ouvert en écriture par ailleurs.
Cette constante peut être combinée avec les constantes de type du fichier.
hMémoBin
(valeur par défaut)
Le fichier est un fichier binaire quelconque.
hMémoImgLe fichier est de type image.
hMémoOleLe fichier est de type OLE.
hMémoWavLe fichier est de type son.

PHPOLE DBConnecteurs Natifs (Accès Natifs) Ce paramètre n'est pas pris en compte.
AndroidWidget AndroidJava Ce paramètre est disponible uniquement pour les fichiers de données au format HFSQL.
<Informations> : Chaîne de caractères optionnelle
Message d'information (65535 caractères maximum) stocké avec le fichier. Ce message peut être relu grâce à la fonction HInfoMémo.
PHPOLE DBConnecteurs Natifs (Accès Natifs) Ce paramètre n'est pas pris en compte.
AndroidWidget AndroidJava Ce paramètre est disponible uniquement pour les fichiers de données au format HFSQL.
WINDEVWEBDEV - Code Serveur

Associer un fichier à une rubrique de type mémo binaire via une variable de type Enregistrement Masquer les détails

<Résultat> = HAttacheMémo(<Rubrique mémo> [, <Fichier à attacher> [, <Type> [, <Informations>]]])
<Résultat> : Booléen
  • Vrai si l'opération a été réalisée,
  • Faux en cas de problème. La fonction HErreur permet d'identifier l'erreur. Si le fichier à associer est ouvert en écriture et si la constante hAccepteFichierOuvert n'a pas été utilisée, la fonction renverra une erreur.
<Rubrique mémo> : Variable de type Enregistrement
Rubrique mémo dans laquelle le fichier binaire doit être ajouté. Utilisez la notation <Nom variable Enregistrement>.<Nom rubrique mémo>.
Si seul le paramètre <Rubrique mémo> est précisé, la fonction HAttacheMémo annule l'attachement existant entre le fichier binaire et la rubrique.
<Fichier à attacher> : Chaîne de caractères optionnelle
Nom du fichier à associer à la rubrique de type mémo binaire. Ce nom peut correspondre :
  • soit au chemin complet du fichier à attacher,
  • soit au chemin relatif (par rapport au répertoire en cours) du fichier à attacher.
Si ce paramètre n'est pas précisé ou correspond à une chaîne vide (""), l'attachement en cours est supprimé.
<Type> : Combinaison de constantes de type Entier, optionnelle
Indique le type du fichier à attacher et le mode de lecture du fichier.
hAccepteFichierOuvertAutorise la lecture du fichier source à ajouter dans le mémo si ce fichier source est ouvert en écriture par ailleurs.
Cette constante peut être combinée avec les constantes de type du fichier.
hMémoBin
(valeur par défaut)
Le fichier est un fichier binaire quelconque.
hMémoImgLe fichier est de type image.
hMémoOleLe fichier est de type OLE.
hMémoWavLe fichier est de type son.
<Informations> : Chaîne de caractères optionnelle
Message d'information (65535 caractères maximum) stocké avec le fichier. Ce message peut être relu grâce à la fonction HInfoMémo.
OLE DBConnecteurs Natifs (Accès Natifs) Ce paramètre n'est pas pris en compte.
Remarques

Annuler l'attachement existant

Si seuls les paramètres <Fichier de données> et <Rubrique> sont précisés, la fonction HAttacheMémo annule l'attachement existant entre le fichier binaire et la rubrique.
WINDEVWEBDEV - Code ServeurEtats et RequêtesJavaCode Utilisateur (MCU)AjaxHFSQL ClassicHFSQL Client/ServeurProcédures stockéesHyper File 5.5OLE DBConnecteurs Natifs (Accès Natifs)

Différence entre les fonctions BinaireCharge et HAttacheMémo

A la différence de la fonction BinaireCharge (conservée par compatibilité avec WINDEV 5.5), la fonction HAttacheMémo ne charge pas le fichier binaire en mémoire. Il n'y a donc aucun risque de saturation de la mémoire lors de l'association d'un fichier de taille importante à une rubrique de type mémo.
WINDEVWEBDEV - Code ServeurEtats et RequêtesUniversal Windows 10 AppiPhone/iPadWidget IOSMac CatalystJavaCode Utilisateur (MCU)Langage ExterneAjaxHFSQL ClassicHFSQL Client/ServeurProcédures stockées

Vignettes HFSQL

Si la rubrique manipulée utilise des vignettes HFSQL, les vignettes seront automatiquement générées avec le nouveau fichier lors de l'ajout ou de la modification de l'enregistrement (fonctions HAjoute, HModifie ou HEcrit).
Connecteurs Natifs (Accès Natifs)

Gestion des mémos sous SQLite

Le stockage d'informations sous forme de mémos est conseillé uniquement pour des données de taille peu volumineuse (inférieures à 1 Mo). Il est recommandé d'enregistrer directement les données sous forme de fichier externe sur la mémoire du téléphone (interne ou externe) et de mémoriser dans la base uniquement le chemin d'accès à ces données.
Composante : wd290hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 03/07/2023

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