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 <Source>.ChangeNom : Utilisation avec les Connecteurs Natifs et/ou le provider OLE DB
  • Divers
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
<Source>.ChangeNom (Fonction)
En anglais : <Source>.ChangeName
ODBCNon disponible avec ce type de connexion
Modifie le nom physique d'un fichier de données.
Rappel : Par défaut, le fichier physique est créé avec le nom qui lui a été donné dans l'analyse.
Exemple
// Création du fichier de statistiques de janvier
Stat.ChangeNom("StatistiquesJanvier")
Stat.Création()
Syntaxe
<Résultat> = <Source>.ChangeNom(<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.
<Source> : Type correspondant à la source spécifiée
Nom du fichier de données (défini dans l'analyse). Ce nom est utilisé dans toutes les fonctions de manipulation des fichiers de données HFSQL.
<Nom physique> : Chaîne de caractères
Nouveau nom physique du fichier de données.
  • Si ce paramètre est une chaîne vide (""), le nom physique utilisé correspondra au nom physique défini dans l'analyse.
  • Ce paramètre ne doit contenir ni nom de lecteur, ni nom de répertoires.
  • Ce nom sera conservé à la fermeture du fichier de données.
  • La propriété NomPhysique permet de connaître le nom physique donné au fichier de données par la fonction <Source>.ChangeNom.
OLE DBConnecteurs Natifs (Accès Natifs) Selon la base de données utilisée, le nom physique du fichier de données 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 du fichier de données sous l'éditeur d'analyses (option "Nom de la table dans la base de données externe").
  • la fonction <Source>.ChangeNom permet également de changer le nom physique du fichier de données. Consultez également le paragraphe Utilisation avec les Connecteurs Natifs et/ou le provider OLE DB.
Remarques

Conditions d'utilisation

  • Le fichier de données doit être fermé pour que cette modification soit prise en compte (utilisez la fonction <Source>.Ferme si nécessaire), sinon la modification sera prise en compte lors de la prochaine ouverture.
  • Connecteurs Natifs (Accès Natifs) XML : La fonction <Source>.ChangeNom modifie le nom du TAG XML associé au fichier de données décrit dans l'analyse (ne change donc pas le nom physique du fichier). 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 <Source>.ChangeConnexion.

Changements de nom multiples

La fonction <Source>.ChangeNom 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 fichier de données, le dernier nom physique donné remplace tous les autres.

Changement de répertoire ou de lecteur

La fonction <Source>.ChangeNom permet uniquement de changer le nom du fichier physique. Pour modifier son emplacement, utilisez les fonctions <Source>.ChangeRep et HSubstRep.
WINDEVWEBDEV - Code ServeurEtats et RequêtesCode Utilisateur (MCU)AjaxOLE DBConnecteurs Natifs (Accès Natifs)

Fonction <Source>.ChangeNom : Utilisation avec les Connecteurs Natifs et/ou le provider OLE DB

Par défaut, le nom logique fourni à la fonction <Source>.ChangeNom 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 <Source>.ChangeNom, 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 <Source>.ChangeNom, il est nécessaire de passer la chaîne "DBO"."CLIENT".
Il faut donc utiliser le code suivant :
Client.ChangeNom("""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 <Source>.ChangeNom est équivalente à la fonction HSubstNom disponible dans WINDEV 5.5/WEBDEV 1.5.
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