PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE


  • Conditions d'utilisation
  • Changements de nom multiples
  • Changement de répertoire ou de lecteur
  • HChangeNom : Utilisation avec les Accès 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
HChangeNom (Fonction)
En anglais : HChangeName
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.
Versions 15 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
Android Cette fonction est désormais disponible pour les applications Android.
Android Cette fonction est désormais disponible pour les applications Android.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
// Création du fichier de statistiques de janvier
HChangeNom(Stat, "StatistiquesJanvier")
HCréation(Stat)
Syntaxe
<Résultat> = HChangeNom(<Nom logique du fichier> , <Nom physique du fichier>)
<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.
<Nom logique du fichier> : Chaîne de caractères (avec ou sans guillemets)
Nom logique 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 du fichier> : Chaîne de caractères (avec guillemets)
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 par la fonction HChangeNom.
OLE DBAccè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. Dans ce cas :
  • le nom physique complet est indiqué dans la description du fichier sous l'éditeur d'analyses (option "Nom de la table dans la base de données externe").
  • la fonction HChangeNom permet également de changer le nom physique du fichier de données. Consultez également le paragraphe Utilisation avec les Accès 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 HFerme si nécessaire), sinon la modification sera prise en compte lors de la prochaine ouverture.
  • Accès Natifs XML : La fonction HChangeNom 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 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 fichier de données, 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.
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjaxCode Utilisateur (MCU)OLE DBAccès Natifs

HChangeNom : Utilisation avec les Accès 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> 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 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 : wd240hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire