fOuvreFichierTemp (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des fichiers externes

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

fOuvreFichierTemp (Fonction)

En anglais : fOpenTempFile

Crée et ouvre un fichier temporaire. Le système fournit un nom de fichier temporaire unique.

Nouveauté SaaS

Cette fonction est désormais disponible pour les applications Android.

Cette fonction est désormais disponible en mode Widget Android.

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Cette fonction est désormais disponible en mode Widget iOS.

Exemple

// Récupération de l'identifiant du fichier temporaire
ResFichierTempUnique = fOuvreFichierTemp(foSuppressionAutomatique, "ABC", "C:\MesRépertoires")
SI ResFichierTempUnique = -1 ALORS 
	Erreur(ErreurInfo()) 
SINON
	fEcritLigne(ResFichierTempUnique, "Compte-rendu du " + DateSys())
	...
FIN

MonFichierTempUnique est un FichierDisque
MonFichierTempUnique = fOuvreFichierTemp(foSuppressionAutomatique, "ABC", "C:\MesRépertoires")
SI ErreurDétectée ALORS
	Erreur(ErreurInfo()) 
SINON
	fEcritLigne(MonFichierTempUnique, "Compte-rendu du " + DateSys())
	...
FIN

// Ouverture d'un fichier temporaire
MonFichierTemporaire est un FichierDisque
ResOuverture est un booléen
ResOuverture = fOuvreFichierTemp(MonFichierTemporaire, foLectureEcriture, "ABC", "C:\MesRépertoires")
SI ResOuverture ALORS
	...
FIN

Syntaxe

Créer et ouvrir un fichier temporaire Masquer les détails

<Résultat> = fOuvreFichierTemp([<Mode d'ouverture> [, <Préfixe du fichier temporaire> [, <Répertoire du fichier temporaire>]]])

<Résultat> : Entier ou variable de type FichierDisque

Correspond à :
un entier :
Identifiant du fichier temporaire. Cet identifiant sera utilisé dans toutes les fonctions de manipulation des fichiers externes.
-1 en cas d'erreur. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
une variable de type FichierDisque. En cas d'erreur, la variable ErreurDétectée est à Vrai. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
Non disponible.

<Mode d'ouverture> : Constante (ou combinaison de constantes) optionnelle

Constantes permettant de définir le mode d'ouverture du fichier, le mode d'accès au fichier et le mode de blocage du fichier.
Mode de blocage du fichier et mode d'ouverture du fichier :
foBloqueEcriture Les autres applications ne pourront pas modifier le fichier en cours.

Cette constante n'est pas disponible.
foBloqueLecture Les autres applications ne pourront pas lire le fichier en cours.

Cette constante n'est pas disponible.
foSansSuppression Le fichier ne sera pas automatiquement supprimé à sa fermeture.
Valeur par défaut.
foSuppressionAutomatique Le fichier est bloqué lors de son ouverture et sera automatiquement supprimé à sa fermeture (appel de la fonction fFerme ou à la fin de l'application).
Si le fichier a été ouvert par une autre application, il sera supprimé automatiquement par le système lorsque toutes les applications auront fermé le fichier.
Valeur par défaut.
Cette constante n'est pas disponible.
Si le fichier est utilisé par une autre application lors de sa fermeture (appel de la fonction fFerme ou à la fin de l'application), il ne sera pas supprimé.
Mode d'accès au fichier. Ce type est utilisé par les fonctions fLitLigne et fEcritLigne pour déterminer le type des informations à lire et écrire dans le fichier externe :
foAnsi Fichier de type Ansi. Cette constante permet de gérer un fichier Ansi lorsque le mode "Utiliser les chaînes Unicode en exécution" est activé au niveau de la configuration de projet.
Mode utilisé par défaut :
dans les projets WINDEV et WEBDEV inférieurs à la version 17.
dans les configurations de projet WINDEV et WEBDEV utilisant le mode "Utiliser les chaînes Ansi en exécution" à partir de la version 17.
foUnicode Fichier de type Unicode. Cette constante permet de gérer un fichier Unicode lorsque le mode "Utiliser les chaînes Ansi en exécution" est activé au niveau de la configuration de projet.
Mode utilisé par défaut :
dans les projets WINDEV Mobile quels que soient le mode et la version utilisés.
dans les configurations de projet WINDEV et WEBDEV utilisant le mode "Utiliser les chaînes Unicode en exécution" à partir de la version 17.
Cette constante n'est pas disponible.

<Préfixe du fichier temporaire> : Chaîne de caractères optionnelle

Préfixe (3 lettres) du nom du fichier temporaire. Ce paramètre permet de préfixer le nom du fichier temporaire. Seules les trois premières lettres seront prises en compte.
Ce paramètre peut être au format Ansi ou Unicode.

<Répertoire du fichier temporaire> : Chaîne de caractères optionnelle

Répertoire (complet ou relatif) du fichier temporaire (260 caractères maximum). Un chemin de type UNC peut être utilisé. Ce nom de répertoire peut être terminé indifféremment par le caractère "\" ou non. Ce répertoire doit exister. Dans le cas contraire, une erreur WLangage est affichée.
Si ce paramètre n'est pas précisé, le répertoire par défaut sera :
le répertoire temporaire de Windows (si ce répertoire existe sur le poste en cours),
le répertoire en cours (si le répertoire temporaire de Windows n'existe pas sur le poste en cours).
Ce paramètre peut être au format Ansi ou Unicode.

Créer et ouvrir un fichier temporaire dans une variable de type FichierDisque Masquer les détails

<Résultat> = fOuvreFichierTemp(<FichierDisque> [, <Mode d'ouverture> [, <Préfixe du fichier temporaire> [, <Répertoire du fichier temporaire>]]])

<Résultat> : Booléen

Vrai si le fichier temporaire a été créé, ouvert et associé à la variable de type FichierDisque,
Faux dans le cas contraire. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.

<FichierDisque> : Variable de type FichierDisque

Nom de la variable FichierDisque qui sera associée au fichier temporaire manipulé.

<Mode d'ouverture> : Constante (ou combinaison de constantes) optionnelle

Constantes permettant de définir le mode d'ouverture du fichier, le mode d'accès au fichier et le mode de blocage du fichier.
Mode de blocage du fichier et mode d'ouverture du fichier :
foBloqueEcriture Les autres applications ne pourront pas modifier le fichier en cours.

Cette constante n'est pas disponible.
foBloqueLecture Les autres applications ne pourront pas lire le fichier en cours.

Cette constante n'est pas disponible.
foSansSuppression Le fichier ne sera pas automatiquement supprimé à sa fermeture.
Valeur par défaut.
foSuppressionAutomatique Le fichier est bloqué lors de son ouverture et sera automatiquement supprimé à sa fermeture (appel de la fonction fFerme ou à la fin de l'application).
Si le fichier a été ouvert par une autre application, il sera supprimé automatiquement par le système lorsque toutes les applications auront fermé le fichier.
Valeur par défaut.
Cette constante n'est pas disponible.
Si le fichier est utilisé par une autre application lors de sa fermeture (appel de la fonction fFerme ou à la fin de l'application), il ne sera pas supprimé.
Mode d'accès au fichier. Ce type est utilisé par les fonctions fLitLigne et fEcritLigne pour déterminer le type des informations à lire et écrire dans le fichier externe :
foAnsi Fichier de type Ansi. Cette constante permet de gérer un fichier Ansi lorsque le mode "Utiliser les chaînes Unicode en exécution" est activé au niveau de la configuration de projet.
Mode utilisé par défaut :
dans les projets WINDEV et WEBDEV inférieurs à la version 17.
dans les configurations de projet WINDEV et WEBDEV utilisant le mode "Utiliser les chaînes Ansi en exécution" à partir de la version 17.
foUnicode Fichier de type Unicode. Cette constante permet de gérer un fichier Unicode lorsque le mode "Utiliser les chaînes Ansi en exécution" est activé au niveau de la configuration de projet.
Mode utilisé par défaut :
dans les projets WINDEV Mobile quels que soient le mode et la version utilisés.
dans les configurations de projet WINDEV et WEBDEV utilisant le mode "Utiliser les chaînes Unicode en exécution" à partir de la version 17.
Cette constante n'est pas disponible.

<Préfixe du fichier temporaire> : Chaîne de caractères optionnelle

Préfixe (3 lettres) du nom du fichier temporaire. Ce paramètre permet de préfixer le nom du fichier temporaire. Seules les trois premières lettres seront prises en compte.
Ce paramètre peut être au format Ansi ou Unicode.

<Répertoire du fichier temporaire> : Chaîne de caractères optionnelle

Répertoire (complet ou relatif) du fichier temporaire (260 caractères maximum). Un chemin de type UNC peut être utilisé. Ce nom de répertoire peut être terminé indifféremment par le caractère "\" ou non. Ce répertoire doit exister. Dans le cas contraire, une erreur WLangage est affichée.
Si ce paramètre n'est pas précisé, le répertoire par défaut sera :
le répertoire temporaire de Windows (si ce répertoire existe sur le poste en cours),
le répertoire en cours (si le répertoire temporaire de Windows n'existe pas sur le poste en cours).
Ce paramètre peut être au format Ansi ou Unicode.

Remarques

La fonction fOuvreFichierTemp génère une erreur dans les cas suivants :

le répertoire indiqué n'existe pas,
le fichier est bloqué par un autre poste ou par une autre application,
l'utilisateur n'a pas les droits en lecture ou en écriture sur le fichier à ouvrir.

Classification Métier / UI : Code métier

Composante : wd300std.dll

Voir Aussi

Version minimum requise

Version 14

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 03/06/2024

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