PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Procédure manipulant chaque fichier listé
  • Interruption de FTPListeFichier
  • Délai de transfert
  • Navigateur Internet
  • Permissions requises
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Liste les fichiers d'un répertoire (et/ou les répertoires) d'un serveur FTP et retourne le nombre de fichiers (et/ou de répertoires) listés.
Les fichiers listés sont recherchés dans un répertoire donné. Pour chaque fichier trouvé, FTPListeFichier appelle automatiquement une procédure spécifique. Cette procédure permet de manipuler le fichier en cours. Cette procédure doit renvoyer un résultat (Vrai pour continuer à lister les répertoires et / ou les fichiers, Faux pour arrêter).
Attention : Cette fonction n'est pas récursive. La recherche est effectuée dans le répertoire indiqué, sans tenir compte des sous-répertoires.
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 18 et supérieures
Widget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 18
Widget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WINDEVWEBDEV - Code ServeurEtats et RequêtesAndroidWidget AndroidWindows MobileJavaAjaxCode Utilisateur (MCU)
// Liste les fichiers .BMP présents dans "/Documents" sur le serveur FTP.
// La procédure AttributFichier retourne le nombre de fichiers en lecture seule.
ResListeFichier = FTPListeFichier(7, "/Documents/*.BMP", "AttributFichier")
Syntaxe
<Résultat> = FTPListeFichier(<Identifiant de la connexion> , <Chemin et nom générique des fichiers> , <Nom de la procédure> [, <Fichiers/Répertoires> [, <Paramètre>]])
<Résultat> : Entier
  • Nombre de fichiers listés,
  • 0 (en cas d'erreur). Pour savoir si cette fonction a généré une erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
<Identifiant de la connexion> : Entier
Identifiant de la connexion, obtenu avec la fonction FTPConnecte.
PHP Ce paramètre est de type Variant.
<Chemin et nom générique des fichiers> : Chaîne de caractères (avec guillemets)
Chemin et nom générique des fichiers (et des répertoires) à lister. Les caractères génériques (* et ?) sont autorisés. Les parties du chemin sont séparées par des "slash" (barre oblique normale, "/").
Si le chemin est du type "/<NomRépertoire>/<NomFichier>" : le chemin de recherche est "/<NomRépertoire>/<NomFichier>".
Si le chemin est du type "<NomRépertoire>/<NomFichier>" : le chemin de recherche est "/<RépertoireCourantServeur>/<NomRépertoire>/<NomFichier>".
<Nom de la procédure> : Chaîne de caractères (avec ou sans guillemets)
Nom de la procédure ("callback") appelée pour chaque fichier listé. Cette procédure permet de manipuler le fichier en cours. Cette procédure doit renvoyer un résultat.
Pour forcer l'interruption du parcours, cette procédure doit renvoyer Faux, et pour poursuivre le parcours, la procédure DOIT renvoyer Vrai.
Les paramètres de cette procédure sont optionnels.
Il n'est pas nécessaire de passer des paramètres à cette procédure. En effet, ces paramètres sont renseignés automatiquement à chaque fichier traité.
<Fichiers/Répertoires> : Constante (ou combinaison de constantes) optionnelle
Indique les éléments recherchés :
ftpFichierLa recherche est effectuée uniquement sur les fichiers.
ftpRépertoireLa recherche est effectuée uniquement sur les répertoires.
Par défaut, ce paramètre vaut ftpFichier+ftpRépertoire : la recherche est effectuée sur les fichiers et les répertoires.
<Paramètre> : Type correspondant à la valeur passée (optionnel)
Paramètre passé à la procédure <Nom de la procédure>.
Remarques

Procédure manipulant chaque fichier listé

Pour chaque fichier trouvé, la fonction FTPListeFichier appelle automatiquement la procédure <Nom de la procédure>. Cette procédure est déclarée de la manière suivante :
PROCEDURE <Nom de la procédure> (<Fichier> [, <Taille> [, <Attribut> ...
[, <Date> [, <Heure> [, <Paramètre de la procédure>]]]]])
  • <Fichier> : nom du fichier ou du répertoire manipulé.
  • <Taille> : entier optionnel correspondant à la taille du fichier trouvé en octets. Ce paramètre n'est pas à prendre en compte dans le cas d'un répertoire.
  • <Attribut> : chaîne de caractères optionnelle décrivant les attributs du fichier ou du répertoire trouvé. Le format utilisé est identique à celui de la fonction FTPAttribut.
  • <Date> : chaîne de caractères optionnelle correspondant à la date de modification du fichier (ou du répertoire) trouvé. Le format utilisé est "AAAAMMJJ".
  • <Heure> : chaîne de caractères optionnelle correspondant à l'heure de modification du fichier (ou du répertoire) trouvé. Le format utilisé est "HHMMSS".
  • <Paramètre de la procédure> : correspond à la valeur passée au <Paramètre> de la fonction FTPListeFichier. Si <Paramètre> n'est pas précisé, <Paramètre de la procédure> vaut 0.
Attention : Dans la procédure <Nom de la procédure> :
  • aucune fonction FTP utilisant la même connexion que celle de la fonction FTPListeFichier ne doit être appelée.
  • il est possible de récupérer les propriétés (nom, taille, attributs, dates et heures) du fichier listé à l'aide des fonctions FTPNom, FTPTaille, FTPAttribut, FTPDate et FTPHeure. Cependant, cette solution est coûteuse en temps : elle provoque une requête supplémentaire sur le serveur FTP. Il est donc préférable de lire directement les paramètres optionnels passés à la fonction <Nom de la procédure>.

Interruption de FTPListeFichier

La fonction FTPListeFichier ne peut pas être interrompue tant qu'il reste des fichiers à parcourir. Pour forcer l'interruption du parcours, il faut utiliser la ligne suivante dans la procédure <Nom de la procédure> :
RENVOYER Faux
Dans ce cas, la fonction FTPListeFichier retourne le nombre de fichiers parcourus jusqu'à l'appel de "RENVOYER Faux".
Dans les autres cas (pour poursuivre le parcours), la procédure <Nom de la procédure> DOIT renvoyer Vrai.
Si la procédure <Nom de la procédure> ne retourne aucune valeur (ni Vrai, ni Faux), une erreur est générée.

Délai de transfert

Par défaut, toutes les fonctions FTP échouent si aucune réponse du serveur FTP n'est reçue après 20 secondes. Ce délai peut être modifié lors de la connexion au serveur FTP avec la fonction FTPConnecte.
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjaxCode Utilisateur (MCU)

Navigateur Internet

La fonction FTPListeFichier nécessite l'installation d'Internet Explorer version 3 ou supérieure.
En cas de difficulté, il est conseillé de tester avec le navigateur en lui passant directement un lien de la forme "ftp://serveur/...". En cas de problème avec Internet Explorer (par exemple avec un serveur UNIX), utilisez directement la fonction FTPCommande.
AndroidWidget Android

Permissions requises

L’utilisation de cette fonction entraîne la modification des permissions requises par l’application.
Permission requise : INTERNET
Cette permission autorise l’application à ouvrir des sockets réseau.
Liste des exemples associés :
Les fonctions FTP Exemples unitaires (WINDEV) : Les fonctions FTP
[ + ] Utilisation des principales fonctions FTP de WINDEV :
- Se connecter à un serveur FTP
- Lister les fichiers et les répertoires présents sur le serveur FTP
- Récupérer des fichiers présents sur le serveur FTP
- Se déconnecter d'un serveur FTP
Classification Métier / UI : Code métier
Composante : wd250com.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire