Functions > Network >


InetRead

T�l�charge un fichier depuis internet en utilisant le protocole HTTP, HTTPS ou FTP.

InetRead ( "URL" [, options = 0] )

Param�tres

URL URL du fichier � t�l�charger. Voir les remarques ci-dessous.
options [optionnel]
    $INET_LOCALCACHE (0) = (d�faut) R�cup�re le fichier depuis le cache local si disponible.
    $INET_FORCERELOAD (1) = Force le rechargement depuis le site distant.
    $INET_IGNORESSL (2) = Ignore toutes les erreurs SSL (avec connexions HTTPS).
    $INET_ASCIITRANSFER (4) = Utilise ASCII lors du transfert de fichiers avec le protocole FTP (Ne peut pas �tre combin� avec le flag $INET_BINARYTRANSFER (8)).
    $INET_BINARYTRANSFER (8) = Utilise BINARY lors du transfert de fichiers avec le protocole FTP (Ne peut pas �tre combin� avec le flag $INET_ASCIITRANSFER (4)). Ceci est le mode de transfert par d�faut si aucun n'est fourni.
    $INET_FORCEBYPASS (16) = Force la connexion en ligne par contournement (Voir Remarques).
Les constantes sont d�finies dans InetConstants.au3

Valeur de retour

Succ�s: Retourne une cha�ne binaire et assigne � @extended le nombre d'octets t�l�charg�s.
�chec: Retourne "" (cha�ne vide) et d�finit @error <> 0.

Remarques

Internet Explorer 3 ou plus r�cent doit �tre install� pour faire fonctionner la fonction.

Le param�tre URL devrait �tre de la forme "http://www.lesite.com/chemin/fichier.html" - tout comme une adresse que vous tapez dans votre navigateur web.

Pour utiliser un nom d'utilisateur et un mot de passe lors de la connexion, pr�fixez simplement le nom de serveur avec "nomutilisateur:motdepasse@", par exemple:
"http://nomutilisateur:[email protected]"

Les donn�es retourn�es sont au format binaire. La fonction BinaryToString() peut-�tre utilis�e pour convertir les donn�es en cha�ne.

Par d�faut, AutoIt force une connexion avant de d�marrer un t�l�chargement. Les utilisateurs de modem analogique seront invit�s � passer en ligne ou le num�ro sera compos� (selon la configuration du syst�me). L'option $INET_FORCEBYPASS (16) d�sactive ce comportement. D�sactiver ce comportement peut-�tre utile pour les connexions continues (Large bande, LAN). Cependant, il est aussi n�cessaire de travailler sur certains probl�mes dans Windows Vista et Windows 7.

En relation

FtpSetProxy, HttpSetProxy, HttpSetUserAgent, InetGet, InetGetSize

Exemple

#include <MsgBoxConstants.au3>

Example()

Func Example()
    ; Lit le fichier sans le t�l�charger dans un dossier. L'option 'obtenir le fichier � partir du cache local' est choisie.
    Local $dData = InetRead("http://www.autoitscript.com/autoit3/files/beta/update.dat")

    ; Le nombre d'octets lus est retourn� en utilisant la macro @extended.
    Local $iBytesRead = @extended

    ; Convertit la cha�ne binaire compatible ANSI en une cha�ne.
    Local $sData = BinaryToString($dData)

    ; Affiche les r�sultats.
    MsgBox($MB_SYSTEMMODAL, "", "Nombre d'octets lus: " & $iBytesRead & @CRLF & @CRLF & $sData)
EndFunc   ;==>Example