Network.DownloadFile メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定されたリモート ファイルをダウンロードし、指定された場所に保存します。
オーバーロード
| DownloadFile(String, String) |
指定されたリモート ファイルをダウンロードし、指定された場所に保存します。 |
| DownloadFile(Uri, String) |
指定されたリモート ファイルをダウンロードし、指定された場所に保存します。 |
| DownloadFile(String, String, String, String) |
指定されたリモート ファイルをダウンロードし、指定された場所に保存します。 |
| DownloadFile(Uri, String, String, String) |
指定されたリモート ファイルをダウンロードし、指定された場所に保存します。 |
| DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean) |
指定されたリモート ファイルをダウンロードし、指定された場所に保存します。 |
| DownloadFile(String, String, String, String, Boolean, Int32, Boolean) |
指定されたリモート ファイルをダウンロードし、指定された場所に保存します。 |
| DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption) |
指定されたリモート ファイルをダウンロードし、指定された場所に保存します。 |
| DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean) |
指定されたリモート ファイルをダウンロードし、指定された場所に保存します。 |
| DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption) |
指定されたリモート ファイルをダウンロードし、指定された場所に保存します。 |
| DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption) |
指定されたリモート ファイルをダウンロードし、指定された場所に保存します。 |
DownloadFile(String, String)
指定されたリモート ファイルをダウンロードし、指定された場所に保存します。
public:
void DownloadFile(System::String ^ address, System::String ^ destinationFileName);public void DownloadFile (string address, string destinationFileName);member this.DownloadFile : string * string -> unitPublic Sub DownloadFile (address As String, destinationFileName As String)パラメーター
- address
- String
ダウンロードするファイルのパス (ファイル名とホスト アドレスを含む)。
- destinationFileName
- String
ダウンロード ファイルの名前およびパス。
例外
destinationFileName がスラッシュで終わっています。
既定のタイムアウト時間 (100 秒) 内にサーバーが応答しません。
ユーザーは、ネットワーク操作を実行するために必要なアクセス許可を持っていません。
要求は対象の Web サーバーで拒否されました。
例
この例では、 からhttp://www.cohowinery.com/downloadsファイルWineList.txtをダウンロードし、 にC:\Documents and Settings\All Users\Documents保存します。
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/WineList.txt",
"C:\Documents and Settings\All Users\Documents\WineList.txt")
この例では、 からhttp://www.cohowinery.com/downloadsファイルWineList.txtをダウンロードし、 にC:\Documents and Settings\All Users\Documents保存し、タイムアウト間隔を 500 ミリ秒で指定します。
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
注釈
変換先ファイルが既に存在する場合、 DownloadFile メソッドは既存のファイルを上書きしません。 メソッドの他のオーバーロードのいずれかを使用して、既存のファイルの上書き、ユーザー資格情報の DownloadFile 指定、または特定のタイムアウト値の指定を指示できます。
DownloadFile では、アプリケーションでネットワーク トレースを有効にすると、トレース情報が出力されます。 詳細については、「 ネットワーク トレースの有効化」を参照してください。
注意
メソッドは DownloadFile 省略可能な HTTP ヘッダーを送信しません。 オプションのユーザー エージェント ヘッダーがない場合、一部のサーバーから 500 (内部サーバー エラー) が返されることがあります。 省略可能なヘッダーを送信するには、 クラスを使用して要求を作成する WebClient 必要があります。
次の表に、 メソッドを含むタスクの例を My.Computer.Network.DownloadFile 示します。
| 終了 | 解決方法については、 |
|---|---|
| ファイルをダウンロードする | 方法: ファイルをダウンロードする |
こちらもご覧ください
- Uri
- ICredentials
- オブジェクト (Visual Basic)
- 方法 : Visual Basic でファイルをダウンロードする
- 方法 : Visual Basic でファイル パスを解析する
適用対象
DownloadFile(Uri, String)
指定されたリモート ファイルをダウンロードし、指定された場所に保存します。
public:
void DownloadFile(Uri ^ address, System::String ^ destinationFileName);public void DownloadFile (Uri address, string destinationFileName);member this.DownloadFile : Uri * string -> unitPublic Sub DownloadFile (address As Uri, destinationFileName As String)パラメーター
- address
- Uri
ダウンロードするファイルのパス (ファイル名とホスト アドレスを含む)。
- destinationFileName
- String
ダウンロード ファイルの名前およびパス。
例外
destinationFileName がスラッシュで終わっています。
既定のタイムアウト時間 (100 秒) 内にサーバーが応答しません。
ユーザーは、ネットワーク操作を実行するために必要なアクセス許可を持っていません。
要求は対象の Web サーバーで拒否されました。
例
この例では、 からhttp://www.cohowinery.com/downloadsファイルWineList.txtをダウンロードし、 にC:\Documents and Settings\All Users\Documents保存します。
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/WineList.txt",
"C:\Documents and Settings\All Users\Documents\WineList.txt")
この例では、 からhttp://www.cohowinery.com/downloadsファイルWineList.txtをダウンロードし、 にC:\Documents and Settings\All Users\Documents保存し、タイムアウト間隔を 500 ミリ秒で指定します。
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
注釈
変換先ファイルが既に存在する場合、 DownloadFile メソッドは既存のファイルを上書きしません。 メソッドの他のオーバーロードのいずれかを使用して、既存のファイルの上書き、ユーザー資格情報の DownloadFile 指定、または特定のタイムアウト値の指定を指示できます。 DownloadFile では、アプリケーションでネットワーク トレースを有効にすると、トレース情報が出力されます。 詳細については、「 ネットワーク トレースの有効化」を参照してください。
注意
メソッドは DownloadFile 省略可能な HTTP ヘッダーを送信しません。 オプションのユーザー エージェント ヘッダーがない場合、一部のサーバーから 500 (内部サーバー エラー) が返されることがあります。 省略可能なヘッダーを送信するには、 クラスを使用して要求を作成する WebClient 必要があります。
次の表に、 メソッドを含むタスクの例を My.Computer.Network.DownloadFile 示します。
| 終了 | 解決方法については、 |
|---|---|
| ファイルをダウンロードする | 方法: ファイルをダウンロードする |
こちらもご覧ください
- Uri
- ICredentials
- オブジェクト (Visual Basic)
- 方法 : Visual Basic でファイルをダウンロードする
- 方法 : Visual Basic でファイル パスを解析する
適用対象
DownloadFile(String, String, String, String)
指定されたリモート ファイルをダウンロードし、指定された場所に保存します。
public:
void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password);public void DownloadFile (string address, string destinationFileName, string userName, string password);member this.DownloadFile : string * string * string * string -> unitPublic Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String)パラメーター
- address
- String
ダウンロードするファイルのパス (ファイル名とホスト アドレスを含む)。
- destinationFileName
- String
ダウンロード ファイルの名前およびパス。
- userName
- String
認証するユーザー名。 既定値は空の文字列 ("") です。
- password
- String
認証するパスワード。 既定値は空の文字列 ("") です。
例外
destinationFileName がスラッシュで終わっています。
既定のタイムアウト時間 (100 秒) 内にサーバーが応答しません。
ユーザーは、ネットワーク操作を実行するために必要なアクセス許可を持っていません。
要求は対象の Web サーバーで拒否されました。
例
この例では、 からhttp://www.cohowinery.com/downloadsファイルWineList.txtをダウンロードし、 にC:\Documents and Settings\All Users\Documents保存します。
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/WineList.txt",
"C:\Documents and Settings\All Users\Documents\WineList.txt")
この例では、 からhttp://www.cohowinery.com/downloadsファイルWineList.txtをダウンロードし、 にC:\Documents and Settings\All Users\Documents保存し、タイムアウト間隔を 500 ミリ秒で指定します。
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
注釈
変換先ファイルが既に存在する場合、 DownloadFile メソッドは既存のファイルを上書きしません。 メソッドの他のオーバーロードのいずれかを使用して、既存の DownloadFile ファイルを上書きするか、特定のタイムアウト値を指定するように指示できます。
DownloadFile では、アプリケーションでネットワーク トレースを有効にすると、トレース情報が出力されます。 詳細については、「 ネットワーク トレースの有効化」を参照してください。
注意
メソッドは DownloadFile 省略可能な HTTP ヘッダーを送信しません。 オプションのユーザー エージェント ヘッダーがない場合、一部のサーバーから 500 (内部サーバー エラー) が返されることがあります。 省略可能なヘッダーを送信するには、 クラスを使用して要求を作成する WebClient 必要があります。
注意
FTP プロトコルは、パスワードを含む情報をプレーン テキストで送信します。機密情報の送信には使用しないでください。
次の表に、 メソッドを含むタスクの例を My.Computer.Network.DownloadFile 示します。
| 終了 | 解決方法については、 |
|---|---|
| ファイルをダウンロードする | 方法: ファイルをダウンロードする |
こちらもご覧ください
- Uri
- ICredentials
- オブジェクト (Visual Basic)
- 方法 : Visual Basic でファイルをダウンロードする
- 方法 : Visual Basic でファイル パスを解析する
適用対象
DownloadFile(Uri, String, String, String)
指定されたリモート ファイルをダウンロードし、指定された場所に保存します。
public:
void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password);public void DownloadFile (Uri address, string destinationFileName, string userName, string password);member this.DownloadFile : Uri * string * string * string -> unitPublic Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String)パラメーター
- address
- Uri
ダウンロードするファイルのパス (ファイル名とホスト アドレスを含む)。
- destinationFileName
- String
ダウンロード ファイルの名前およびパス。
- userName
- String
認証するユーザー名。 既定値は空の文字列 ("") です。
- password
- String
認証するパスワード。 既定値は空の文字列 ("") です。
例外
destinationFileName がスラッシュで終わっています。
既定のタイムアウト時間 (100 秒) 内にサーバーが応答しません。
ユーザーは、ネットワーク操作を実行するために必要なアクセス許可を持っていません。
要求は対象の Web サーバーで拒否されました。
例
この例では、 からhttp://www.cohowinery.com/downloadsファイルWineList.txtをダウンロードし、 にC:\Documents and Settings\All Users\Documents保存します。
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/WineList.txt",
"C:\Documents and Settings\All Users\Documents\WineList.txt")
この例では、 からhttp://www.cohowinery.com/downloadsファイルWineList.txtをダウンロードし、 にC:\Documents and Settings\All Users\Documents保存し、タイムアウト間隔を 500 ミリ秒で指定します。
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
注釈
変換先ファイルが既に存在する場合、 DownloadFile メソッドは既存のファイルを上書きしません。 メソッドの他のオーバーロードのいずれかを使用して、既存の DownloadFile ファイルを上書きするか、特定のタイムアウト値を指定するように指示できます。
DownloadFile では、アプリケーションでネットワーク トレースを有効にすると、トレース情報が出力されます。 詳細については、「 ネットワーク トレースの有効化」を参照してください。
注意
メソッドは DownloadFile 省略可能な HTTP ヘッダーを送信しません。 オプションのユーザー エージェント ヘッダーがない場合、一部のサーバーから 500 (内部サーバー エラー) が返されることがあります。 省略可能なヘッダーを送信するには、 クラスを使用して要求を作成する WebClient 必要があります。
注意
FTP プロトコルは、パスワードを含む情報をプレーン テキストで送信します。機密情報の送信には使用しないでください。
次の表に、 メソッドを含むタスクの例を My.Computer.Network.DownloadFile 示します。
| 終了 | 解決方法については、 |
|---|---|
| ファイルをダウンロードする | 方法: ファイルをダウンロードする |
こちらもご覧ください
- Uri
- ICredentials
- オブジェクト (Visual Basic)
- 方法 : Visual Basic でファイルをダウンロードする
- 方法 : Visual Basic でファイル パスを解析する
適用対象
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)
指定されたリモート ファイルをダウンロードし、指定された場所に保存します。
public:
void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::Net::ICredentials ^ networkCredentials, bool showUI, int connectionTimeout, bool overwrite);public void DownloadFile (Uri address, string destinationFileName, System.Net.ICredentials networkCredentials, bool showUI, int connectionTimeout, bool overwrite);member this.DownloadFile : Uri * string * System.Net.ICredentials * bool * int * bool -> unitPublic Sub DownloadFile (address As Uri, destinationFileName As String, networkCredentials As ICredentials, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)パラメーター
- destinationFileName
- String
String. ダウンロード ファイルの名前およびパス。
- networkCredentials
- ICredentials
ICredentials. 指定される資格情報。
- showUI
- Boolean
操作の進行状況を表示する場合は True。それ以外の場合は False。 既定値は False です。
- connectionTimeout
- Int32
タイムアウト間隔 (ミリ秒単位)。 既定値は 100 秒です。
- overwrite
- Boolean
既存のファイルを上書きする場合は True。それ以外の場合は False。 既定値は False です。
例外
destinationFileName がスラッシュで終わっています。
overwrite が False に設定されていますが、コピー先のファイルが既に存在します。
指定した connectionTimeout 内にサーバーが応答しない場合。
ユーザーは、ネットワーク操作を実行するために必要なアクセス許可を持っていません。
要求は対象の Web サーバーで拒否されました。
例
この例では、 からhttp://www.cohowinery.com/downloadsファイルWineList.txtをダウンロードし、 にC:\Documents and Settings\All Users\Documents保存します。
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/WineList.txt",
"C:\Documents and Settings\All Users\Documents\WineList.txt")
この例では、 からhttp://www.cohowinery.com/downloadsファイルWineList.txtをダウンロードし、 にC:\Documents and Settings\All Users\Documents保存し、タイムアウト間隔を 500 ミリ秒で指定します。
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
注釈
が にTrue設定されている場合showUI、操作の進行状況を示すダイアログ ボックスが表示されます。ダイアログ ボックスには、操作の取り消しに使用できる [キャンセル] ボタンが表示されます。 ダイアログ ボックスはモーダルでないため、プログラム内の他のウィンドウへのユーザー入力はブロックされません。
指定した connectionTimeout内でサーバーが応答しない場合、操作は取り消され、例外がスローされます。
DownloadFile では、アプリケーションでネットワーク トレースを有効にすると、トレース情報が出力されます。 詳細については、「 ネットワーク トレースの有効化」を参照してください。
注意
メソッドは DownloadFile 省略可能な HTTP ヘッダーを送信しません。 オプションのユーザー エージェント ヘッダーがない場合、一部のサーバーから 500 (内部サーバー エラー) が返されることがあります。 省略可能なヘッダーを送信するには、 クラスを使用して要求を作成する WebClient 必要があります。
注意
FTP プロトコルは、パスワードを含む情報をプレーン テキストで送信します。機密情報の送信には使用しないでください。
次の表に、 メソッドを含むタスクの例を My.Computer.Network.DownloadFile 示します。
| 終了 | 解決方法については、 |
|---|---|
| ファイルをダウンロードする | 方法: ファイルをダウンロードする |
こちらもご覧ください
- Uri
- ICredentials
- オブジェクト (Visual Basic)
- 方法 : Visual Basic でファイルをダウンロードする
- 方法 : Visual Basic でファイル パスを解析する
適用対象
DownloadFile(String, String, String, String, Boolean, Int32, Boolean)
指定されたリモート ファイルをダウンロードし、指定された場所に保存します。
public:
void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite);public void DownloadFile (string address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite);member this.DownloadFile : string * string * string * string * bool * int * bool -> unitPublic Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)パラメーター
- address
- String
ダウンロードするファイルのパス (ファイル名とホスト アドレスを含む)。
- destinationFileName
- String
ダウンロード ファイルの名前およびパス。
- userName
- String
認証するユーザー名。 既定値は空の文字列 ("") です。
- password
- String
認証するパスワード。 既定値は空の文字列 ("") です。
- showUI
- Boolean
操作の進行状況を表示する場合は True。それ以外の場合は False。 既定値は False です。
- overwrite
- Boolean
既存のファイルを上書きする場合は True。それ以外の場合は False。 既定値は False です。
例外
destinationFileName がスラッシュで終わっています。
overwrite が False に設定されていますが、コピー先のファイルが既に存在します。
指定した connectionTimeout 内にサーバーが応答しない場合。
ユーザーは、ネットワーク操作を実行するために必要なアクセス許可を持っていません。
要求は対象の Web サーバーで拒否されました。
例
この例では、 からhttp://www.cohowinery.com/downloadsファイルWineList.txtをダウンロードし、 にC:\Documents and Settings\All Users\Documents保存します。
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/WineList.txt",
"C:\Documents and Settings\All Users\Documents\WineList.txt")
この例では、 からhttp://www.cohowinery.com/downloadsファイルWineList.txtをダウンロードし、 にC:\Documents and Settings\All Users\Documents保存し、タイムアウト間隔を 500 ミリ秒で指定します。
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
注釈
が にTrue設定されている場合showUI、操作の進行状況を示すダイアログ ボックスが表示されます。ダイアログ ボックスには、操作の取り消しに使用できる [キャンセル] ボタンが表示されます。 ダイアログ ボックスはモーダルでないため、プログラム内の他のウィンドウへのユーザー入力はブロックされません。
指定した connectionTimeout内でサーバーが応答しない場合、操作は取り消され、例外がスローされます。
DownloadFile では、アプリケーションでネットワーク トレースを有効にすると、トレース情報が出力されます。 詳細については、「 ネットワーク トレースの有効化」を参照してください。
注意
メソッドは DownloadFile 省略可能な HTTP ヘッダーを送信しません。 オプションのユーザー エージェント ヘッダーがない場合、一部のサーバーから 500 (内部サーバー エラー) が返されることがあります。 省略可能なヘッダーを送信するには、 クラスを使用して要求を作成する WebClient 必要があります。
注意
FTP プロトコルは、パスワードを含む情報をプレーン テキストで送信します。機密情報の送信には使用しないでください。
次の表に、 メソッドを含むタスクの例を My.Computer.Network.DownloadFile 示します。
| 終了 | 解決方法については、 |
|---|---|
| ファイルをダウンロードする | 方法: ファイルをダウンロードする |
こちらもご覧ください
- Uri
- ICredentials
- オブジェクト (Visual Basic)
- 方法 : Visual Basic でファイルをダウンロードする
- 方法 : Visual Basic でファイル パスを解析する
適用対象
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)
指定されたリモート ファイルをダウンロードし、指定された場所に保存します。
public:
void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::Net::ICredentials ^ networkCredentials, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);public void DownloadFile (Uri address, string destinationFileName, System.Net.ICredentials networkCredentials, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);member this.DownloadFile : Uri * string * System.Net.ICredentials * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unitPublic Sub DownloadFile (address As Uri, destinationFileName As String, networkCredentials As ICredentials, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)パラメーター
- address
- Uri
ダウンロードするファイルのパス (ファイル名とホスト アドレスを含む)。
- destinationFileName
- String
ダウンロード ファイルの名前およびパス。
- networkCredentials
- ICredentials
指定される資格情報。
- showUI
- Boolean
操作の進行状況を表示する場合は True。それ以外の場合は False。 既定値は False です。
- connectionTimeout
- Int32
タイムアウト間隔 (ミリ秒単位)。 既定値は 100 秒です。
- overwrite
- Boolean
既存のファイルを上書きする場合は True。それ以外の場合は False。 既定値は False です。
- onUserCancel
- UICancelOption
が に設定された場合に表示されるダイアログ ボックスで、ユーザーが [キャンセル] または showUI[いいえ]True をクリックしたときの動作を指定します。 既定値は ThrowException です。
例外
destinationFileName がスラッシュで終わっています。
overwrite が False に設定されていますが、コピー先のファイルが既に存在します。
指定した connectionTimeout 内にサーバーが応答しない場合。
ユーザーは、ネットワーク操作を実行するために必要なアクセス許可を持っていません。
要求は対象の Web サーバーで拒否されました。
例
この例では、 からhttp://www.cohowinery.com/downloadsファイルWineList.txtをダウンロードし、 にC:\Documents and Settings\All Users\Documents保存します。
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/WineList.txt",
"C:\Documents and Settings\All Users\Documents\WineList.txt")
この例では、 からhttp://www.cohowinery.com/downloadsファイルWineList.txtをダウンロードし、 にC:\Documents and Settings\All Users\Documents保存し、タイムアウト間隔を 500 ミリ秒で指定します。
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
注釈
が にTrue設定されている場合showUI、操作の進行状況を示すダイアログ ボックスが表示されます。ダイアログ ボックスには、操作の取り消しに使用できる [キャンセル] ボタンが表示されます。 ダイアログ ボックスはモーダルでないため、プログラム内の他のウィンドウへのユーザー入力はブロックされません。
指定した connectionTimeout内でサーバーが応答しない場合、操作は取り消され、例外がスローされます。
DownloadFile では、アプリケーションでネットワーク トレースを有効にすると、トレース情報が出力されます。 詳細については、「 ネットワーク トレースの有効化」を参照してください。
注意
メソッドは DownloadFile 省略可能な HTTP ヘッダーを送信しません。 オプションのユーザー エージェント ヘッダーがない場合、一部のサーバーから 500 (内部サーバー エラー) が返されることがあります。 省略可能なヘッダーを送信するには、 クラスを使用して要求を作成する WebClient 必要があります。
注意
FTP プロトコルは、パスワードを含む情報をプレーン テキストで送信します。機密情報の送信には使用しないでください。
次の表に、 メソッドを含むタスクの例を My.Computer.Network.DownloadFile 示します。
| 終了 | 解決方法については、 |
|---|---|
| ファイルをダウンロードする | 方法: ファイルをダウンロードする |
こちらもご覧ください
- Uri
- ICredentials
- オブジェクト (Visual Basic)
- 方法 : Visual Basic でファイルをダウンロードする
- 方法 : Visual Basic でファイル パスを解析する
適用対象
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)
指定されたリモート ファイルをダウンロードし、指定された場所に保存します。
public:
void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite);public void DownloadFile (Uri address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite);member this.DownloadFile : Uri * string * string * string * bool * int * bool -> unitPublic Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)パラメーター
- address
- Uri
ダウンロードするファイルのパス (ファイル名とホスト アドレスを含む)。
- destinationFileName
- String
ダウンロード ファイルの名前およびパス。
- userName
- String
認証するユーザー名。 既定値は空の文字列 ("") です。
- password
- String
認証するパスワード。 既定値は空の文字列 ("") です。
- showUI
- Boolean
操作の進行状況を表示する場合は True。それ以外の場合は False。 既定値は False です。
- connectionTimeout
- Int32
タイムアウト間隔 (ミリ秒単位)。 既定値は 100 秒です。
- overwrite
- Boolean
既存のファイルを上書きする場合は True。それ以外の場合は False。 既定値は False です。
例外
destinationFileName がスラッシュで終わっています。
overwrite が False に設定されていますが、コピー先のファイルが既に存在します。
指定した connectionTimeout 内にサーバーが応答しない場合。
ユーザーは、ネットワーク操作を実行するために必要なアクセス許可を持っていません。
要求は対象の Web サーバーで拒否されました。
例
この例では、 からhttp://www.cohowinery.com/downloadsファイルWineList.txtをダウンロードし、 にC:\Documents and Settings\All Users\Documents保存します。
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/WineList.txt",
"C:\Documents and Settings\All Users\Documents\WineList.txt")
この例では、 からhttp://www.cohowinery.com/downloadsファイルWineList.txtをダウンロードし、 にC:\Documents and Settings\All Users\Documents保存し、タイムアウト間隔を 500 ミリ秒で指定します。
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
注釈
が にTrue設定されている場合showUI、操作の進行状況を示すダイアログ ボックスが表示されます。ダイアログ ボックスには、操作の取り消しに使用できる [キャンセル] ボタンが表示されます。 ダイアログ ボックスはモーダルでないため、プログラム内の他のウィンドウへのユーザー入力はブロックされません。
指定した connectionTimeout内でサーバーが応答しない場合、操作は取り消され、例外がスローされます。
DownloadFile では、アプリケーションでネットワーク トレースを有効にすると、トレース情報が出力されます。 詳細については、「 ネットワーク トレースの有効化」を参照してください。
注意
メソッドは DownloadFile 省略可能な HTTP ヘッダーを送信しません。 オプションのユーザー エージェント ヘッダーがない場合、一部のサーバーから 500 (内部サーバー エラー) が返されることがあります。 省略可能なヘッダーを送信するには、 クラスを使用して要求を作成する WebClient 必要があります。
注意
FTP プロトコルは、パスワードを含む情報をプレーン テキストで送信します。機密情報の送信には使用しないでください。
次の表に、 メソッドを含むタスクの例を My.Computer.Network.DownloadFile 示します。
| 終了 | 解決方法については、 |
|---|---|
| ファイルをダウンロードする | 方法: ファイルをダウンロードする |
こちらもご覧ください
- Uri
- ICredentials
- オブジェクト (Visual Basic)
- 方法 : Visual Basic でファイルをダウンロードする
- 方法 : Visual Basic でファイル パスを解析する
適用対象
DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)
指定されたリモート ファイルをダウンロードし、指定された場所に保存します。
public:
void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);public void DownloadFile (string address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);member this.DownloadFile : string * string * string * string * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unitPublic Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)パラメーター
- address
- String
ダウンロードするファイルのパス (ファイル名とホスト アドレスを含む)。
- destinationFileName
- String
ダウンロード ファイルの名前およびパス。
- userName
- String
認証するユーザー名。 既定値は空の文字列 ("") です。
- password
- String
認証するパスワード。 既定値は空の文字列 ("") です。
- showUI
- Boolean
操作の進行状況を表示する場合は True。それ以外の場合は False。 既定値は False です。
- connectionTimeout
- Int32
タイムアウト間隔 (ミリ秒単位)。 既定値は 100 秒です。
- overwrite
- Boolean
既存のファイルを上書きする場合は True。それ以外の場合は False。 既定値は False です。
- onUserCancel
- UICancelOption
が に設定された場合に表示されるダイアログ ボックスで、ユーザーが [キャンセル] または ShowUI[いいえ]True をクリックしたときの動作を指定します。 既定値は ThrowException です。
例外
destinationFileName がスラッシュで終わっています。
overwrite が False に設定されていますが、コピー先のファイルが既に存在します。
指定した connectionTimeout 内にサーバーが応答しない場合。
ユーザーは、ネットワーク操作を実行するために必要なアクセス許可を持っていません。
要求は対象の Web サーバーで拒否されました。
例
この例では、 からhttp://www.cohowinery.com/downloadsファイルWineList.txtをダウンロードし、 にC:\Documents and Settings\All Users\Documents保存します。
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/WineList.txt",
"C:\Documents and Settings\All Users\Documents\WineList.txt")
この例では、 からhttp://www.cohowinery.com/downloadsファイルWineList.txtをダウンロードし、 にC:\Documents and Settings\All Users\Documents保存し、タイムアウト間隔を 500 ミリ秒で指定します。
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
注釈
が にTrue設定されている場合showUI、操作の進行状況を示すダイアログ ボックスが表示されます。ダイアログ ボックスには、操作の取り消しに使用できる [キャンセル] ボタンが表示されます。 ダイアログ ボックスはモーダルでないため、プログラム内の他のウィンドウへのユーザー入力はブロックされません。
指定した connectionTimeout内でサーバーが応答しない場合、操作は取り消され、例外がスローされます。
DownloadFile では、アプリケーションでネットワーク トレースを有効にすると、トレース情報が出力されます。 詳細については、「 ネットワーク トレースの有効化」を参照してください。
注意
メソッドは DownloadFile 省略可能な HTTP ヘッダーを送信しません。 オプションのユーザー エージェント ヘッダーがない場合、一部のサーバーから 500 (内部サーバー エラー) が返されることがあります。 省略可能なヘッダーを送信するには、 クラスを使用して要求を作成する WebClient 必要があります。
注意
FTP プロトコルは、パスワードを含む情報をプレーン テキストで送信します。機密情報の送信には使用しないでください。
次の表に、 メソッドを含むタスクの例を My.Computer.Network.DownloadFile 示します。
| 終了 | 解決方法については、 |
|---|---|
| ファイルをダウンロードする | 方法: ファイルをダウンロードする |
こちらもご覧ください
- Uri
- ICredentials
- オブジェクト (Visual Basic)
- 方法 : Visual Basic でファイルをダウンロードする
- 方法 : Visual Basic でファイル パスを解析する
適用対象
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)
指定されたリモート ファイルをダウンロードし、指定された場所に保存します。
public:
void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);public void DownloadFile (Uri address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);member this.DownloadFile : Uri * string * string * string * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unitPublic Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)パラメーター
- address
- Uri
ダウンロードするファイルのパス (ファイル名とホスト アドレスを含む)。
- destinationFileName
- String
ダウンロード ファイルの名前およびパス。
- userName
- String
認証するユーザー名。 既定値は空の文字列 ("") です。
- password
- String
認証するパスワード。 既定値は空の文字列 ("") です。
- showUI
- Boolean
操作の進行状況を表示する場合は True。それ以外の場合は False。 既定値は False です。
- connectionTimeout
- Int32
タイムアウト間隔 (ミリ秒単位)。 既定値は 100 秒です。
- overwrite
- Boolean
既存のファイルを上書きする場合は True。それ以外の場合は False。 既定値は False です。
- onUserCancel
- UICancelOption
が に設定された場合に表示されるダイアログ ボックスで、ユーザーが [キャンセル] または ShowUI[いいえ]True をクリックしたときの動作を指定します。 既定値は ThrowException です。
例外
destinationFileName がスラッシュで終わっています。
overwrite が False に設定されていますが、コピー先のファイルが既に存在します。
指定した connectionTimeout 内にサーバーが応答しない場合。
ユーザーは、ネットワーク操作を実行するために必要なアクセス許可を持っていません。
要求は対象の Web サーバーで拒否されました。
例
この例では、 からhttp://www.cohowinery.com/downloadsファイルWineList.txtをダウンロードし、 にC:\Documents and Settings\All Users\Documents保存します。
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/WineList.txt",
"C:\Documents and Settings\All Users\Documents\WineList.txt")
この例では、 からhttp://www.cohowinery.com/downloadsファイルWineList.txtをダウンロードし、 にC:\Documents and Settings\All Users\Documents保存し、タイムアウト間隔を 500 ミリ秒で指定します。
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
注釈
が にTrue設定されている場合showUI、操作の進行状況を示すダイアログ ボックスが表示されます。ダイアログ ボックスには、操作の取り消しに使用できる [キャンセル] ボタンが表示されます。 ダイアログ ボックスはモーダルでないため、プログラム内の他のウィンドウへのユーザー入力はブロックされません。
指定した connectionTimeout内でサーバーが応答しない場合、操作は取り消され、例外がスローされます。
DownloadFile では、アプリケーションでネットワーク トレースを有効にすると、トレース情報が出力されます。 詳細については、「 ネットワーク トレースの有効化」を参照してください。
注意
メソッドは DownloadFile 省略可能な HTTP ヘッダーを送信しません。 オプションのユーザー エージェント ヘッダーがない場合、一部のサーバーから 500 (内部サーバー エラー) が返されることがあります。 省略可能なヘッダーを送信するには、 クラスを使用して要求を作成する WebClient 必要があります。
注意
FTP プロトコルは、パスワードを含む情報をプレーン テキストで送信します。機密情報の送信には使用しないでください。
次の表に、 メソッドを含むタスクの例を My.Computer.Network.DownloadFile 示します。
| 終了 | 解決方法については、 |
|---|---|
| ファイルをダウンロードする | 方法: ファイルをダウンロードする |
こちらもご覧ください
- Uri
- ICredentials
- オブジェクト (Visual Basic)
- 方法 : Visual Basic でファイルをダウンロードする
- 方法 : Visual Basic でファイル パスを解析する
適用対象
.NET
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示