InetRead
Lädt eine Datei aus dem Internet herunter mit dem HTTP, HTTPS oder FTP Protokoll.
InetRead ( "URL" [, options = 0] )
Parameter
| URL | Die URL der herunterzuladenden Datei. Siehe die Anmerkungen unten. |
| options | [optional] $INET_LOCALCACHE (0) = Holt die Datei aus dem lokalen Cache wenn verfügbar (Standard). $INET_FORCERELOAD (1) = Zwingt die Seite neu zu laden. $INET_IGNORESSL (2) = Alle SSL Error ignorieren (mit HTTPS Verbindungen). $INET_ASCIITRANSFER (4) = ASCII-Code benutzen wenn Daten mit dem FTP Protokoll übertragen werden. (Kann nicht mit Option $INET_BINARYTRANSFER (8) kombiniert werden). $INET_BINARYTRANSFER (8) = Binär-Code benutzen wenn Daten mit dem FTP Protokoll übertragen werden. (Kann nicht mit Option $INET_ASCIITRANSFER (4) kombiniert werden). Dies ist der Standard Übertragungs-Modus wenn keiner angegeben wird. $INET_FORCEBYPASS (16) = Das Zwingen der Verbindung Online zu bleiben umgehen. (Siehe Anmerkungen). Die Konstanten sind in InetConstants.au3 definiert |
Rückgabewert
| Erfolg: | ein Binär-String und @extended wird auf die Anzahl der heruntergeladenen Bytes gesetzt. |
| Fehler: | "" (Leerstring) und setzt @error auf einen Wert ungleich 0. |
Bemerkungen
Der URL Parameter sollte in dieser Form sein "http://www.irgendeineseite.com/pfad/Datei.html" - so wie eine Adresse die in einen Browser eingegeben wird.
Um einen Benutzernamen und ein Passwort zu verwenden werden diese im Format "benutzername:passwort@" vor den Servernamen geschrieben. Beispiel "http://meinbenutzername:meinpasswort@www.irgendeineseite.com"
Die zurückgegebenen Daten sind im binären Format. Die Funktion BinaryToString() kann benutzt werden, um die Daten in einen String umzuwandeln.
Normalerweise erzwingt AutoIt eine Verbindung bevor der Download gestartet wird. DFÜ-Benutzer werden aufgefordert online zu gehen oder sich in das Modem einzuwählen (abhängig davon, wie das System konfiguriert ist). Die Option $INET_FORCEBYPASS (16) verhindert dieses Verhalten. Dieses Verhalten abzuschalten kann sinnvoll sein für dauerhafte Verbindungen (Breitband, LAN). Außerdem ist es auch erforderlich um bestimmte Probleme in Windows Vista und Windows 7 zu umgehen.
Verwandte Funktionen
FtpSetProxy, HttpSetProxy, HttpSetUserAgent, InetGet, InetGetSize
Beispiel
#include <MsgBoxConstants.au3>
Example()
Func Example()
; Liest die Datei ohne dass die Datei in einen Ordner heruntergeladen wird. Die Option 'Holt die Datei aus dem lokalen Cache wenn verfügbar' wurde ausgewählt.
Local $bData = InetRead("http://www.autoitscript.com/autoit3/files/beta/update.dat")
; Die gelesenen Bytes werden durch das @extended Makro zurückgegeben.
Local $iBytesRead = @extended
; Konvertiert den ANSI kompatiblen Binärstring zurück in einen String.
Local $sData = BinaryToString($bData)
; Zeigt das Ergebnis.
MsgBox($MB_SYSTEMMODAL, "", "Die gelesenen Bytes: " & $iBytesRead & @CRLF & @CRLF & $sData)
EndFunc ;==>Example