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 <Source>.AttacheMé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 <Source>.Ajoute, <Source>.Modifie ou <Source>.Ecrit). 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 <Source>.ExtraitMé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
Exemple
// Attache une image à l'enregistrement
Produit.AttacheMémo(Image_Produit, "C:\Images\Produit1.gif", hMémoImg)
// Transfère le contenu des champs dans le buffer du fichier
MaFenêtre.VersFichier()
// Ajoute l'enregistrement
Produit.Ajoute()
Syntaxe

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

<Résultat> = <Source>.AttacheMémo(<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.
<Source> : Type correspondant à la source spécifiée
Nom du fichier de données (ou de la requête) contenant une rubrique mémo.
Si seuls les paramètres <Source> et <Rubrique> sont précisés, la fonction <Source>.AttacheMé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 <Source> et <Rubrique> sont précisés, la fonction <Source>.AttacheMé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é.
Java 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.

OLE DBConnecteurs Natifs (Accès Natifs) Ce paramètre n'est pas pris en compte.
Java 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 <Source>.InfoMémo.
OLE DBConnecteurs Natifs (Accès Natifs) Ce paramètre n'est pas pris en compte.
Java Ce paramètre est disponible uniquement pour les fichiers de données au format HFSQL.
Remarques

Annuler l'attachement existant

Si seuls les paramètres <Fichier de données> et <Rubrique> sont précisés, la fonction <Source>.AttacheMémo annule l'attachement existant entre le fichier binaire et la rubrique.
WINDEVJavaCode Utilisateur (MCU)HFSQL ClassicHFSQL Client/ServeurProcédures stockéesHyper File 5.5OLE DBConnecteurs Natifs (Accès Natifs)

Différence entre les fonctions BinaireCharge et <Source>.AttacheMémo

A la différence de la fonction BinaireCharge (conservée par compatibilité avec WINDEV 5.5), la fonction <Source>.AttacheMé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.
WINDEVUniversal Windows 10 AppJavaCode Utilisateur (MCU)Langage ExterneHFSQL 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 <Source>.Ajoute, <Source>.Modifie ou <Source>.Ecrit).
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 : wd300hf.dll
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 20/06/2023

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