DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Conditions d'utilisation
  • Changements de nom multiples
  • Changement de répertoire ou de lecteur
  • Fonction HChangeNom: Utilisation avec les Connecteurs Natifs et/ou le provider OLE DB
  • Divers
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
HChangeNom (Fonction)
En anglais : HChangeName
ODBCNon disponible avec ce type de connexion
Modifie le nom physique d'une table.
Rappel: Par défaut, le fichier physique est créé avec le nom qui lui a été donné dans le schéma des données.
Exemple
// Création du fichier de statistiques de janvier
HChangeNom(Stat, "StatistiquesJanvier")
HCrée(Stat)
Syntaxe
<Résultat> = HChangeNom(<Table> , <Nom physique>)
<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.
<Table> : Chaîne de caractères
Nom de la table (défini dans le schéma des données). Ce nom est utilisé dans toutes les fonctions de manipulation des tables HFSQL.
<Nom physique> : Chaîne de caractères
Nouveau nom physique de la table.
  • Si ce paramètre est une chaîne vide (""), le nom physique utilisé correspondra au nom physique défini dans le schéma des données.
  • Ce paramètre ne doit contenir ni nom de lecteur, ni nom de répertoires.
  • Ce nom sera conservé à la fermeture de la table.
  • La propriété NomPhysique permet de connaître le nom physique donné à la table par la fonction HChangeNom.
OLE DBConnecteurs Natifs (Accès Natifs) Selon la base de données utilisée, le nom physique de la table peut être préfixé par le nom de la base de données ou le nom de l'utilisateur, ou le nom du schéma. Dans ce cas:
  • le nom physique complet est indiqué dans la description de la table sous l'éditeur de schémas des données (option "Nom de la table dans la base de données externe").
  • la fonction HChangeNom permet également de changer le nom physique de la table. Consultez également le paragraphe Utilisation avec les Connecteurs Natifs et/ou le provider OLE DB.
Remarques

Conditions d'utilisation

  • La table doit être fermée pour que cette modification soit prise en compte (utilisez la fonction HFerme si nécessaire), sinon la modification sera prise en compte lors de la prochaine ouverture.
  • Connecteurs Natifs (Accès Natifs) XML: La fonction HChangeNom modifie le nom du TAG XML associé à la table décrite dans le schéma des données (ne change donc pas le nom physique de la table). Pour changer le nom du fichier, il est nécessaire d'utiliser une connexion (fonction HDécritConnexion en spécifiant le nom du fichier XML comme source de données), puis d'associer cette connexion au fichier avec la fonction HChangeConnexion.

Changements de nom multiples

La fonction HChangeNom peut être appelée plusieurs fois avec des paramètres différents. Lorsque le nom physique est redéfini plusieurs fois pour un même nom logique de table, le dernier nom physique donné remplace tous les autres.

Changement de répertoire ou de lecteur

La fonction HChangeNom permet uniquement de changer le nom du fichier physique. Pour modifier son emplacement, utilisez les fonctions HChangeRep et HSubstRep.
WEBDEV - Code ServeurAjaxOLE DBConnecteurs Natifs (Accès Natifs)

Fonction HChangeNom: Utilisation avec les Connecteurs Natifs et/ou le provider OLE DB

Par défaut, le nom logique fourni à la fonction HChangeNom est considéré comme étant le seul nom de la table. Il est encapsulé en utilisant les caractères d'encapsulation correspondant à la base ou spécifiés par le provider OLE DB avant d'être envoyé à la base (ce qui permet de gérer des noms de table contenant des caractères spéciaux).
Pour fournir un nom de fichier composé de <nom du user>.<nom de la table> (ou suivant la base de données <nom du schéma>.<nom de la table>) dans la fonction HChangeNom, il est nécessaire de fournir ces noms déjà formatés (en utilisant les caractères d'encapsulation correspondant à la base de données ou spécifiés par le provider OLE DB).
Exemple pour SQLServer:
Les caractères d'encapsulation sont " ".
Pour changer le nom CLIENT en DBO.CLIENT avec la fonction HChangeNom, il est nécessaire de passer la chaîne "DBO"."CLIENT".
Il faut donc utiliser le code suivant:
HChangeNom(CLIENT, """DBO"".""CLIENT""")

Divers

  • Si la gestion du ".REP" est branchée (fonction HGèreREP), la modification de nom est enregistrée dans le fichier ".REP" (voir gestion du .REP).
  • La fonction HChangeNom est équivalente à la fonction HSubstNom disponible dans WINDEV 5.5/WEBDEV 1.5.
Composante: wd300hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 27/03/2025

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