WebClient.DownloadFileTaskAsync Methode

Definition

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Lädt die angegebene Ressource in eine lokale Datei als asynchroner Vorgang mithilfe eines Taskobjekts herunter. Durch diese Methoden wird der aufrufende Thread nicht blockiert.

Überlädt

DownloadFileTaskAsync(String, String)	Lädt die angegebene Ressource in eine lokale Datei als asynchroner Vorgang mithilfe eines Taskobjekts herunter.
DownloadFileTaskAsync(Uri, String)	Lädt die angegebene Ressource in eine lokale Datei als asynchroner Vorgang mithilfe eines Taskobjekts herunter.

DownloadFileTaskAsync(String, String)

Quelle:

WebClient.cs

Lädt die angegebene Ressource in eine lokale Datei als asynchroner Vorgang mithilfe eines Taskobjekts herunter.

public:
 System::Threading::Tasks::Task ^ DownloadFileTaskAsync(System::String ^ address, System::String ^ fileName);

public System.Threading.Tasks.Task DownloadFileTaskAsync (string address, string fileName);

member this.DownloadFileTaskAsync : string * string -> System.Threading.Tasks.Task

Public Function DownloadFileTaskAsync (address As String, fileName As String) As Task

Parameter

address

String

Der herunterzuladende URI der Ressource.

fileName

String

Der Name der Datei, die auf dem lokalen Computer platziert werden soll.

Gibt zurück

Task

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

ArgumentNullException

Der address-Parameter ist null.

- oder -

Der fileName-Parameter ist null.

WebException

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.

- oder -

Fehler beim Herunterladen der Ressource.

InvalidOperationException

Die von fileName angegebene lokale Datei wird von einem anderen Thread verwendet.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task Objekt wird abgeschlossen, nachdem die Datenressource heruntergeladen wurde.

Diese Methode lädt die Ressource an dem im address Parameter angegebenen URI herunter. Wenn der Download erfolgreich abgeschlossen wurde, wird die heruntergeladene Datei auf dem lokalen Computer benannt fileName . Die Datei wird asynchron mit Threadressourcen heruntergeladen, die automatisch aus dem Threadpool zugeordnet werden.

In .NET Framework und .NET Core 1.0 können Sie asynchrone Vorgänge abbrechen, die noch nicht abgeschlossen wurden, indem Sie die CancelAsync -Methode aufrufen.

Wenn die BaseAddress Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI angibt, muss es sich um einen relativen URI handeln, address der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die QueryString -Eigenschaft keine leere Zeichenfolge ist, wird sie an addressangefügt.

Diese Methode verwendet den RETR-Befehl, um eine FTP-Ressource herunterzuladen. Für eine HTTP-Ressource wird die GET-Methode verwendet.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

Wenn Sie diese Methode auf einer ASP.NET Seite verwenden, erhalten Sie eine Fehlermeldung, wenn das Konto, unter dem die Seite ausgeführt wird, nicht über die Berechtigung für den Zugriff auf die lokale Datei verfügt.

DownloadFileTaskAsync(Uri, String)

Quelle:

WebClient.cs

Lädt die angegebene Ressource in eine lokale Datei als asynchroner Vorgang mithilfe eines Taskobjekts herunter.

public:
 System::Threading::Tasks::Task ^ DownloadFileTaskAsync(Uri ^ address, System::String ^ fileName);

public System.Threading.Tasks.Task DownloadFileTaskAsync (Uri address, string fileName);

member this.DownloadFileTaskAsync : Uri * string -> System.Threading.Tasks.Task

Public Function DownloadFileTaskAsync (address As Uri, fileName As String) As Task

Parameter

address

Uri

Der herunterzuladende URI der Ressource.

fileName

String

Der Name der Datei, die auf dem lokalen Computer platziert werden soll.

Gibt zurück

Task

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

ArgumentNullException

Der address-Parameter ist null.

- oder -

Der fileName-Parameter ist null.

WebException

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.

- oder -

Fehler beim Herunterladen der Ressource.

InvalidOperationException

Die von fileName angegebene lokale Datei wird von einem anderen Thread verwendet.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task Objekt wird abgeschlossen, nachdem die Datenressource heruntergeladen wurde.

Diese Methode lädt die Ressource an dem im address Parameter angegebenen URI herunter. Wenn der Download erfolgreich abgeschlossen wurde, wird die heruntergeladene Datei auf dem lokalen Computer benannt fileName . Die Datei wird asynchron mit Threadressourcen heruntergeladen, die automatisch aus dem Threadpool zugeordnet werden.

In .NET Framework und .NET Core 1.0 können Sie asynchrone Vorgänge abbrechen, die noch nicht abgeschlossen wurden, indem Sie die CancelAsync -Methode aufrufen.

Wenn die BaseAddress Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI angibt, muss es sich um einen relativen URI handeln, address der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die QueryString -Eigenschaft keine leere Zeichenfolge ist, wird sie an addressangefügt.

Diese Methode verwendet den RETR-Befehl, um eine FTP-Ressource herunterzuladen. Für eine HTTP-Ressource wird die GET-Methode verwendet.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

Wenn Sie diese Methode auf einer ASP.NET Seite verwenden, erhalten Sie eine Fehlermeldung, wenn das Konto, unter dem die Seite ausgeführt wird, nicht über die Berechtigung für den Zugriff auf die lokale Datei verfügt.