WebClient.DownloadFileTaskAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
タスク オブジェクトを使用した非同期操作として指定されたリソースをローカル ファイルにダウンロードします。 これらのメソッドは、呼び出し元のスレッドをブロックしません。
オーバーロード
DownloadFileTaskAsync(String, String) |
タスク オブジェクトを使用した非同期操作として指定されたリソースをローカル ファイルにダウンロードします。 |
DownloadFileTaskAsync(Uri, String) |
タスク オブジェクトを使用した非同期操作として指定されたリソースをローカル ファイルにダウンロードします。 |
DownloadFileTaskAsync(String, String)
- ソース:
- WebClient.cs
- ソース:
- WebClient.cs
- ソース:
- WebClient.cs
タスク オブジェクトを使用した非同期操作として指定されたリソースをローカル ファイルにダウンロードします。
public:
System::Threading::Tasks::Task ^ DownloadFileTaskAsync(System::String ^ address, System::String ^ fileName);
public System.Threading.Tasks.Task DownloadFileTaskAsync (string address, string fileName);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task DownloadFileTaskAsync (string address, string fileName);
member this.DownloadFileTaskAsync : string * string -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadFileTaskAsync : string * string -> System.Threading.Tasks.Task
Public Function DownloadFileTaskAsync (address As String, fileName As String) As Task
パラメーター
- address
- String
ダウンロードするリソースの URI。
- fileName
- String
ローカル コンピューターに配置されるファイルの名前。
戻り値
非同期操作を表すタスク オブジェクト。
- 属性
例外
fileName
によって指定されたローカルファイルは別のスレッドで使用されています。
注釈
この操作はブロックされません。 返された Task オブジェクトは、データ リソースのダウンロード後に完了します。
このメソッドは、 パラメーターで 指定された URI でリソースを address
ダウンロードします。 ダウンロードが正常に完了すると、ダウンロードしたファイルの名前がローカル コンピューターに表示 fileName
されます。 ファイルは、スレッド プールから自動的に割り当てられるスレッド リソースを使用して非同期的にダウンロードされます。
.NET Framework と .NET Core 1.0 では、 メソッドを呼び出すことで、完了していない非同期操作を CancelAsync 取り消すことができます。
プロパティが空の BaseAddress 文字列 ("") address
ではなく、絶対 URI を指定しない場合は、 address
と組み合わせて BaseAddress 要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが QueryString 空の文字列でない場合は、 に address
追加されます。
この方法では、RETR コマンドを使用して FTP リソースをダウンロードします。 HTTP リソースの場合は、GET メソッドが使用されます。
Note
このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「 .NET Framework でのネットワーク トレース」を参照してください。
ASP.NET ページでこのメソッドを使用すると、ページが実行されるアカウントにローカル ファイルへのアクセス許可がない場合にエラーが発生します。
適用対象
DownloadFileTaskAsync(Uri, String)
- ソース:
- WebClient.cs
- ソース:
- WebClient.cs
- ソース:
- WebClient.cs
タスク オブジェクトを使用した非同期操作として指定されたリソースをローカル ファイルにダウンロードします。
public:
System::Threading::Tasks::Task ^ DownloadFileTaskAsync(Uri ^ address, System::String ^ fileName);
public System.Threading.Tasks.Task DownloadFileTaskAsync (Uri address, string fileName);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task DownloadFileTaskAsync (Uri address, string fileName);
member this.DownloadFileTaskAsync : Uri * string -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadFileTaskAsync : Uri * string -> System.Threading.Tasks.Task
Public Function DownloadFileTaskAsync (address As Uri, fileName As String) As Task
パラメーター
- address
- Uri
ダウンロードするリソースの URI。
- fileName
- String
ローカル コンピューターに配置されるファイルの名前。
戻り値
非同期操作を表すタスク オブジェクト。
- 属性
例外
fileName
によって指定されたローカルファイルは別のスレッドで使用されています。
注釈
この操作はブロックされません。 返された Task オブジェクトは、データ リソースのダウンロード後に完了します。
このメソッドは、 パラメーターで 指定された URI でリソースを address
ダウンロードします。 ダウンロードが正常に完了すると、ダウンロードしたファイルの名前がローカル コンピューターに表示 fileName
されます。 ファイルは、スレッド プールから自動的に割り当てられるスレッド リソースを使用して非同期的にダウンロードされます。
.NET Framework と .NET Core 1.0 では、 メソッドを呼び出すことで、完了していない非同期操作を CancelAsync 取り消すことができます。
プロパティが空の BaseAddress 文字列 ("") address
ではなく、絶対 URI を指定しない場合は、 address
と組み合わせて BaseAddress 要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが QueryString 空の文字列でない場合は、 に address
追加されます。
この方法では、RETR コマンドを使用して FTP リソースをダウンロードします。 HTTP リソースの場合は、GET メソッドが使用されます。
Note
このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「 .NET Framework でのネットワーク トレース」を参照してください。
ASP.NET ページでこのメソッドを使用すると、ページが実行されるアカウントにローカル ファイルへのアクセス許可がない場合にエラーが発生します。
適用対象
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示