DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Comment décrire une table par programmation?
  • Liste des propriétés HFSQL utilisables pour décrire une table par programmation
  • Les types de tables pouvant être décrits avec la fonction <Source>.DécritTable
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
Décrit une table par programmation.
Après l'appel à la fonction <Source>.DécritTable:
  • la table peut être manipulée comme n'importe quelle table décrite dans le schéma des données.
  • la description de la table ne peut plus être modifiée.
  • la variable de description de la table est ré-initialisée. Une nouvelle description de table peut être effectuée.
Pour annuler la description de table par programmation, utilisez la fonction <Source>.AnnuleDéclaration.
Exemple
UneDescriptionFichier est une Description de Table
UneRubrique est une Description de Rubrique
sdSource est une Source de Données 
 
// Description de la table "CLIENT"
UneDescriptionFichier.Nom = "CLIENT"
UneDescriptionFichier.Type = hTableNormale
UneDescriptionFichier.CryptageFic = hCryptageStandard
 
// Description de la rubrique "NOM"
UneRubrique.Nom = "NOM"
UneRubrique.Type = hRubTexte
UneRubrique.Taille = 40
UneRubrique.TypeClé = hCléUnique
HDécritRubrique(UneDescriptionFichier, UneRubrique)
 
// Description de la rubrique "PRENOM"
UneRubrique.Nom = "PRENOM"
UneRubrique.Type = hRubTexte
UneRubrique.Taille = 40
HDécritRubrique(UneDescriptionFichier, UneRubrique)
 
// Valide la description de la table
sdSource.DécritFichier(UneDescriptionFichier)

HCrée (sdSource)
Syntaxe

Décrire une table par programmation via une source de données Masquer les détails

<Résultat> = <Source de données>.DécritFichier(<Table>)
<Résultat> : Booléen
  • Vrai si la description de la table est valide et peut être utilisée,
  • Faux en cas de problème. La fonction HErreurInfo permet d'identifier l'erreur.
<Source de données> : Variable de type Source de données
Nom de la variable de type Source de données associée à la table.
<Table> : Variable de type Description de fichier
Nom de la variable de type Description de Fichier (voir paragraphe Notes) permettant de décrire la table. Le nom de la table sera défini grâce à la propriété Nom.
Remarques

Comment décrire une table par programmation?

Pour décrire une table par programmation, il faut:
  1. Déclarer une variable de type Source de données.
  2. Utiliser des variables de type Description de Fichier, Description de Rubrique, Description de Liaison et Description d'IndexFullText (si nécessaire).
  3. Décrire les caractéristiques de la table, de ses rubriques, de ses liaisons et de ses index full-text (si nécessaire) grâce aux propriétés HFSQL.
  4. Fixer la description des rubriques avec la fonction HDécritRubrique.
  5. Fixer la description des index full-text avec la fonction HDécritIndexFullText.
  6. Associer la description de la table à la source de données (fonction <Source>.DécritTable, syntaxe 2) et des liaisons si nécessaire (fonction HDécritLiaison).
Remarque: Cette solution permet d'associer la table décrite à une source de données. Dans ce cas, lorsque cette variable sera supprimée, la table sera également supprimée.
Attention: Pour utiliser cette syntaxe, il est nécessaire d'utiliser une source de données "automatique". Pour plus de détails, consultez Description du projet: Onglet Compilation.

Liste des propriétés HFSQL utilisables pour décrire une table par programmation

Les propriétés suivantes sont disponibles en lecture et écriture.
CompressionMmoLa propriété CompressionMmo permet de paramétrer le mode de compression de la table MMO (contenant les mémo binaires et texte) associé à la table.
CryptageFicLa propriété CryptageFic permet de paramétrer le mode de cryptage de la table.
CryptageMmoLa propriété CryptageMmo permet de paramétrer le mode de cryptage du fichier mémo (d'extension .MMO) associé à la table.
CryptageNdxLa propriété CryptageNdx permet de paramétrer le mode de cryptage du fichier d'index (d'extension .NDX) associé à la table.
CxAccèsLa propriété CxAccès permet de gérer le type d'accès à la table lors de la connexion OLE DB à une table spécifique.
CxAccèsDécritLa propriété CxAccèsDécrit permet de gérer le type d'accès à la table lors de la connexion OLE DB à une table spécifique.
CxBaseDeDonnéesLa propriété CxBaseDeDonnées permet de gérer la source de données OLE DB lors de la connexion OLE DB à une table spécifique.
CxBaseDeDonnéesDécriteLa propriété CxBaseDeDonnéesDécrite permet de gérer la source de données OLE DB lors de la connexion OLE DB à une table spécifique.
CxLibelléDécritLa propriété CxLibelléDécrit permet de gérer le libellé de la connexion à la source de données OLE DB.
CxMotDePasseDécritLa propriété CxMotDePasseDécrit permet de définir le mot de passe utilisé pour ouvrir le fichier lors d'une connexion OLE DB (fichier défini par programmation uniquement).
CxProviderOLEDBLa propriété CxProviderOLEDB permet de gérer le nom du provider OLE DB (appelé aussi serveur OLE DB).
CxProviderOLEDBDécritLa propriété CxProviderOLEDBDécrit permet de gérer le nom du provider OLE DB (appelé aussi serveur OLE DB).
CxUtilisateurLa propriété CxUtilisateur permet de paramétrer le nom de l'utilisateur utilisé lors de la connexion OLE DB à une table spécifique.
CxUtilisateurDécritLa propriété CxUtilisateurDécrit permet de paramétrer le nom de l'utilisateur utilisé lors de la connexion OLE DB à une table spécifique.
FormatLa propriété Format permet de paramétrer le format des données de la table.
GrosFichierLa propriété GrosFichier permet de paramétrer la taille maximale possible d'une table.
JournalisationLa propriété Journalisation permet de:
  • connaître le mode de journalisation utilisé pour une table (table définie sous l'éditeur de schémas des données ou définie par programmation).
  • définir le mode de journalisation utilisé pour une table (lors de la description de la table par programmation uniquement).
MotDePasseWDD55La propriété MotDePasseWDD55 permet de spécifier le mot de passe du schéma des données au format 5.5 lors de la description par programmation d'une table au format Hyper File 5.5 dans un schéma des données au format HFSQL Classic.
NomLa propriété Nom permet de connaître:
  • le nom de la police associée à une variable de type Police.
  • le nom d'un champ, d'un état ou d'un bloc d'un état.
  • le nom d'un champ, d'un groupe de champs ou d'une fenêtre.
  • le nom d'un champ, d'un groupe de champs ou d'une page.
Nom55La propriété Nom55 permet de gérer le nom logique d'une table au format Hyper File 5.5 non migré et présent dans un schéma des données au format WINDEV 19.
NomDécritLa propriété NomDécrit permet de gérer le nom logique des tables HFSQL (sans tenir compte des éventuelles modifications effectuées par la fonction <Source>.Alias).
NomPhysiqueLa propriété NomPhysique permet de gérer le nom physique des tables HFSQL.
NomPhysiqueDécritLa propriété NomPhysiqueDécrit permet de gérer le nom physique des tables HFSQL.
RépertoireLa propriété Répertoire permet de gérer le répertoire physique des tables HFSQL.
RépertoireDécritLa propriété RépertoireDécrit permet de gérer le répertoire physique des tables HFSQL.
RépertoireJournalLa propriété RépertoireJournal permet de gérer le répertoire du fichier journal décrit dans le schéma des données.
RubriqueTexteComplétéeLa propriété RubriqueTexteComplétée permet de paramétrer la gestion des rubriques texte dans une table HFSQL.
SécuriséLa propriété Sécurisé permet de paramétrer le niveau de sécurité du cryptage des tables.
TypeLa propriété Type permet de connaître:
  • le type d'un élément décrit par programmation (description de rubrique ou de fichier) ou non (fichier ou rubrique défini sous l'éditeur de schémas des données, vue ou requête).
  • le type d'un objet.
  • le type de la valeur stockée dans un variant.
WDD55La propriété WDD55 permet de:
  • Connaître le nom et le chemin complet du fichier WDD au format Hyper File 5.5.
  • Définir le nom et le chemin complet du fichier WDD au format Hyper File 5.5.

Les types de tables pouvant être décrits avec la fonction <Source>.DécritTable

La propriété Type permet de spécifier le type de la table à créer.
Les types suivants peuvent être créés avec la fonction <Source>.DécritTable:
hTableAS400Fichier AS 400
hTableNormaleFichier normal
hTableOLEDBFichier OLE DB
hTableOracleFichier Oracle
hTableSQLAzureFichier SQL Azure
hTableSQLServerFichier SQL Server
hTableSybaseFichier Sybase
hTableXBaseFichier xBase
Classification Métier / UI: Code métier
Composante: wd300hf.dll
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 14/05/2025

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