DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Fonctions FTP
  • Identification des différents attributs d'un fichier
  • Délai
  • Droits des utilisateurs
  • Chemin relatif et absolu
  • Permissions requises
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
FTPAttribut (Fonction)
En anglais : FTPAttribute
Identifie les attributs d'un fichier présent sur un serveur FTP (File Transfer Protocol).
// Connaître les attributs du fichier
// "/Documents/Fichier.Doc" présent sur le serveur FTP
ResAttributs = FTPAttribut(NumConnexion, "/Documents/Fichier.Doc")
Syntaxe

Identifier les attributs du dernier fichier consulté Masquer les détails

<Résultat> = FTPAttribut()
<Résultat> : Chaîne de caractères
  • "ERR" en cas d'erreur. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
  • Une ou plusieurs lettres correspondant aux attributs du fichier ("AH" par exemple). Les lettres utilisées sont :
    • R : Fichier en lecture seule. Le fichier est uniquement accessible en lecture.
    • H : Fichier caché. Le nom du fichier est généralement grisé ou invisible dans l'explorateur.
      AndroidWidget Android Cette option n'est pas disponible.
    • S : Fichier système. Le fichier est un fichier système Windows.
      AndroidWidget Android Cette option n'est pas disponible.
    • A : Fichier "archive". Cet attribut indique que le fichier peut être archivé. Certains programmes se servent de cet attribut pour savoir quels fichiers ont été sauvegardés.
      AndroidWidget Android Cette option n'est pas disponible.
    • D : Répertoire ou sous-répertoire. Le fichier est un répertoire ou un sous-répertoire.
    • C : Fichier compressé (sur les partitions NTFS). Le fichier a été automatiquement compressé lors de sa copie sur une partition NTFS (Windows NT ou 2000).
      AndroidWidget Android Cette option n'est pas disponible.
Cette syntaxe retourne les attributs du dernier fichier accédé au moyen de l'une des fonctions FTP suivantes : FTPDate, FTPHeure, FTPTaille, FTPListeFichier. Contrairement à la syntaxe 2, aucune requête n'est envoyée au serveur. Cette syntaxe est à privilégier dès que possible.

Identifier les attributs du fichier spécifié Masquer les détails

<Résultat> = FTPAttribut(<Identifiant de la connexion> , <Nom du fichier>)
<Résultat> : Chaîne de caractères
  • "ERR" en cas d'erreur. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage
  • Une ou plusieurs lettres correspondant aux attributs du fichier ("AH" par exemple). Les lettres utilisées sont :
    • R : Fichier en lecture seule. Le fichier est uniquement accessible en lecture.
    • H : Fichier caché. Le nom du fichier est généralement grisé ou invisible dans l'explorateur.
      AndroidWidget Android Cette option n'est pas disponible.
    • S : Fichier système. Le fichier est un fichier système Windows.
      AndroidWidget Android Cette option n'est pas disponible.
    • A : Fichier "archive". Cet attribut indique que le fichier peut être archivé. Certains programmes se servent de cet attribut pour savoir quels fichiers ont été sauvegardés.
      AndroidWidget Android Cette option n'est pas disponible.
    • D : Répertoire ou sous-répertoire. Le fichier est un répertoire ou un sous-répertoire.
    • C : Fichier compressé (sur les partitions NTFS). Le fichier a été automatiquement compressé lors de sa copie sur une partition NTFS (Windows NT ou 2000).
      AndroidWidget Android Cette option n'est pas disponible.
<Identifiant de la connexion> : Entier
Identifiant de la connexion, obtenu avec la fonction FTPConnecte.
<Nom du fichier> : Chaîne de caractères
Nom et chemin absolu (ou relatif) du fichier à manipuler. Les parties du chemin sont séparées par des "slash" (barre oblique normale, "/").
Remarques

Identification des différents attributs d'un fichier

Pour connaître les différents attributs d'un fichier, il suffit de rechercher si une des lettres identifiant un attribut est présente dans <Résultat>. Cette recherche peut être effectuée avec la fonction Position par exemple.

Délai

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.

Droits des utilisateurs

L'identification des attributs de fichiers ou de répertoires présents sur un serveur FTP n'est possible que pour un utilisateur ayant les droits en lecture sur le serveur FTP. En règle générale, les utilisateurs "anonymes" ont les droits en lecture et peuvent donc identifier les attributs d'un fichier ou d'un répertoire présent sur un serveur FTP.

Chemin relatif et absolu

Les notions de chemin relatif et de chemin absolu sont très importantes dans une application FTP.
  • Un chemin commençant par un slash est considéré comme un chemin absolu : il s'agit du chemin par rapport à la racine du serveur FTP (paramètre propre au serveur).
    ex: /pub/user/JULIE
  • Si le chemin ne commence pas par un slash, il est considéré comme un chemin relatif, c'est-à-dire le chemin par rapport au répertoire en cours. Ce répertoire en cours peut-être connu ou modifié avec la fonction FTPRepEnCours.
Lors de la connexion à un site FTP, le répertoire initial, le "home directory" de l'utilisateur n'est pas forcément la racine du serveur FTP. Il est donc conseillé d'utiliser des chemins relatifs.
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.
Composante : wd300com.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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