DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Fonctions Net
  • Progression du transfert de fichiers
  • Fréquence de l'événement
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
Avertissement
Cette fonction est conservée par compatibilité. Il est conseillé d'utiliser un serveur FTP, SSH ou SCP standard. Pour plus de détails, consultez Manipuler des fichiers sur un serveur FTP et Fonctions FTP Standard.
Récupère un fichier existant sur un serveur FTP (File Transfer Protocol) réalisé avec WINDEV. Ce fichier est récupéré par le poste client.
Remarque : Il est possible d'autoriser ou non l'utilisation de cette fonction sur un serveur FTP/RPC grâce à la fonction NetOptionServeur.
// -- Code du bouton de récupération de fichier
Sablier(Vrai)
SI NetRécupèreFichier(ConnectFTP, "C:\autoexec.bat", "C:\autoexec.cli", ...
WM_MYMESSAGE, 10) = Faux ALORS
Erreur("Erreur dans le transfert de fichier")
FIN
Sablier(Faux)
Syntaxe
<Résultat> = NetRécupèreFichier(<Identifiant connexion> , <Fichier du poste serveur> , <Fichier du poste client> [, <Événement> [, <Fréquence événement>]])
<Résultat> : Booléen
  • Vrai si le transfert a été effectué,
  • Faux dans le cas contraire.
La fonction renvoie immédiatement le compte-rendu et le transfert s'effectue en parallèle dans une autre tâche Windows
<Identifiant connexion> : Entier
Identifiant de la connexion (obtenu par la fonction NetConnecte).
<Fichier du poste serveur> : Chaîne de caractères Ansi
Nom complet (nom et chemin) du fichier à copier, présent sur le poste serveur.
<Fichier du poste client> : Chaîne de caractères Ansi
Nom complet (nom et chemin) du fichier copié sur le poste client.
<Événement> : Chaîne de caractères ou entier (optionnel)
Événement personnalisé ou événement Windows envoyé au client pour suivre la progression du transfert (voir Notes).
<Fréquence événement> : Entier optionnel
Fréquence (en pourcentage de la taille du fichier) avec laquelle le message <Événement> est envoyé au client.
Remarques

Progression du transfert de fichiers

La gestion de la progression du transfert de fichiers est uniquement réalisée sur le programme client FTP.
La fonction NetRécupèreFichier n'est jamais bloquante : le transfert de fichiers se fait en tâche de fond. Cependant, il est possible de transférer uniquement un seul fichier à la fois.
Pour transférer plusieurs fichiers, il faut attendre que le transfert de chacun des fichiers soit terminé avant de commencer le suivant.
Dans ce cas, il est possible d'utiliser deux paramètres avec la fonction NetRécupèreFichier :
  • un message de progression (Paramètre <Événement>),
  • une fréquence (paramètre <Fréquence événement>).
La fonction NetRécupèreFichier envoie le message indiqué pour permettre de suivre la progression du transfert. Ce message doit être intercepté par la fonction Evénement. Le message contient deux paramètres :
  • _EVE.wParam indique la taille transférée (indicateur de progression),
  • _EVE.lParam indique la taille totale du fichier.
Le traitement du message de progression est réalisé dans la procédure appelée par la fonction Evénement. Dans cette procédure, il est possible :
  • d'afficher une jauge de progression en utilisant les paramètres du message (_EVE.lParam et _EVE.wParam),
  • de savoir si le transfert du fichier est terminé (dans ce cas, _EVE.lParam = _EVE.wParam).

Fréquence de l'événement

Le paramètre <Fréquence événement> permet de définir la fréquence minimum d'envoi de message. Par exemple, pour un fichier d'une taille de 1 Mo et une fréquence de 10%, on recevra un message à chaque fois que 100Ko sont transférés.
La fréquence détermine le nombre maximum de messages qui peuvent être reçus. Quand le transfert est rapide, le nombre de messages reçus diminue.
Par exemple, pour un fichier de 100Ko et une fréquence de 10%, environ 10 messages seront reçus : 1 message tous les 10Ko transférés. En réalité, le nombre de messages sera inférieur car le transfert est rapide.
Conseils sur le choix de la fréquence :
  • Si aucune jauge de progression ne doit être affichée, le meilleur choix de fréquence est 100% : un seul message sera reçu quand le transfert du fichier est terminé.
  • Si le taux de transfert est lent (transfert par modem par exemple), il est conseillé d'afficher une jauge de progression. Une fréquence de 10% convient dans la majorité des cas.
  • Si le taux de transfert est rapide (réseau local par exemple), il est déconseillé d'utiliser une fréquence trop faible (1% par exemple) car le flux des messages sera élevé et pourra saturer le système. Là encore, une fréquence de 10% convient dans la majorité des cas.
Composante : wd290com.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 07/06/2023

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