Network.DownloadFile メソッド

定義

指定されたリモート ファイルをダウンロードし、指定された場所に保存します。

オーバーロード

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 -> unit
Public Sub DownloadFile (address As String, destinationFileName As String)

パラメーター

address
String

ダウンロードするファイルのパス (ファイル名とホスト アドレスを含む)。

destinationFileName
String

ダウンロード ファイルの名前およびパス。

例外

destinationFileName がスラッシュで終わっています。

既定のタイムアウト時間 (100 秒) 内にサーバーが応答しません。

ユーザーは、ネットワーク操作を実行するために必要なアクセス許可を持っていません。

要求は対象の Web サーバーで拒否されました。

この例では、ファイルWineList.txt``http://www.cohowinery.com/downloadsをダウンロードして保存します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")

次の使用例は、ファイル WineList.txt をダウンロードして http://www.cohowinery.com/downloads 保存 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 示します。

終了 解決方法については、
ファイルをダウンロードする 方法: ファイルをダウンロードする

こちらもご覧ください

適用対象

DownloadFile(Uri, String)

指定されたリモート ファイルをダウンロードし、指定された場所に保存します。

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName);
public void DownloadFile (Uri address, string destinationFileName);
member this.DownloadFile : Uri * string -> unit
Public Sub DownloadFile (address As Uri, destinationFileName As String)

パラメーター

address
Uri

ダウンロードするファイルのパス (ファイル名とホスト アドレスを含む)。

destinationFileName
String

ダウンロード ファイルの名前およびパス。

例外

destinationFileName がスラッシュで終わっています。

既定のタイムアウト時間 (100 秒) 内にサーバーが応答しません。

ユーザーは、ネットワーク操作を実行するために必要なアクセス許可を持っていません。

要求は対象の Web サーバーで拒否されました。

この例では、ファイルWineList.txt``http://www.cohowinery.com/downloadsをダウンロードして保存します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")

次の使用例は、ファイル WineList.txt をダウンロードして http://www.cohowinery.com/downloads 保存 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 示します。

終了 解決方法については、
ファイルをダウンロードする 方法: ファイルをダウンロードする

こちらもご覧ください

適用対象

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 -> unit
Public 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 サーバーで拒否されました。

この例では、ファイルWineList.txt``http://www.cohowinery.com/downloadsをダウンロードして保存します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")

次の使用例は、ファイル WineList.txt をダウンロードして http://www.cohowinery.com/downloads 保存 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 示します。

終了 解決方法については、
ファイルをダウンロードする 方法: ファイルをダウンロードする

こちらもご覧ください

適用対象

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 -> unit
Public 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 サーバーで拒否されました。

この例では、ファイル WineList.txt をダウンロードして http://www.cohowinery.com/downloads 保存します 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")

この例では、ファイル WineList.txt をダウンロードして http://www.cohowinery.com/downloads 保存 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 示します。

終了 解決方法については、
ファイルをダウンロードする 方法: ファイルをダウンロードする

こちらもご覧ください

適用対象

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 -> unit
Public Sub DownloadFile (address As Uri, destinationFileName As String, networkCredentials As ICredentials, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)

パラメーター

address
Uri

String または Uri。 ダウンロードするファイルのパス (ファイル名とホスト アドレスを含む)。

destinationFileName
String

String. ダウンロード ファイルの名前およびパス。

networkCredentials
ICredentials

ICredentials. 指定される資格情報。

showUI
Boolean

操作の進行状況を表示する場合は True。それ以外の場合は False。 既定値は False です。

connectionTimeout
Int32

タイムアウト間隔 (ミリ秒単位)。 既定値は 100 秒です。

overwrite
Boolean

既存のファイルを上書きする場合は True。それ以外の場合は False。 既定値は False です。

例外

destinationFileName がスラッシュで終わっています。

overwriteFalse に設定されていますが、コピー先のファイルが既に存在します。

指定した connectionTimeout 内にサーバーが応答しない場合。

ユーザーは、ネットワーク操作を実行するために必要なアクセス許可を持っていません。

要求は対象の Web サーバーで拒否されました。

この例では、ファイル WineList.txt をダウンロードして http://www.cohowinery.com/downloads 保存します 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")

この例では、ファイル WineList.txt をダウンロードして http://www.cohowinery.com/downloads 保存 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 示します。

終了 解決方法については、
ファイルをダウンロードする 方法: ファイルをダウンロードする

こちらもご覧ください

適用対象

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 -> unit
Public 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 です。

connectionTimeout
Int32

Int32. タイムアウト間隔 (ミリ秒単位)。 既定値は 100 秒です。

overwrite
Boolean

既存のファイルを上書きする場合は True。それ以外の場合は False。 既定値は False です。

例外

destinationFileName がスラッシュで終わっています。

overwriteFalse に設定されていますが、コピー先のファイルが既に存在します。

指定した connectionTimeout 内にサーバーが応答しない場合。

ユーザーは、ネットワーク操作を実行するために必要なアクセス許可を持っていません。

要求は対象の Web サーバーで拒否されました。

この例では、ファイル WineList.txt をダウンロードして http://www.cohowinery.com/downloads 保存します 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")

この例では、ファイル WineList.txt をダウンロードして http://www.cohowinery.com/downloads 保存 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 示します。

終了 解決方法については、
ファイルをダウンロードする 方法: ファイルをダウンロードする

こちらもご覧ください

適用対象

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 -> unit
Public 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 がスラッシュで終わっています。

overwriteFalse に設定されていますが、コピー先のファイルが既に存在します。

指定した connectionTimeout 内にサーバーが応答しない場合。

ユーザーは、ネットワーク操作を実行するために必要なアクセス許可を持っていません。

要求は対象の Web サーバーで拒否されました。

この例では、ファイル WineList.txt をダウンロードして http://www.cohowinery.com/downloads 保存します 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")

この例では、ファイル WineList.txt をダウンロードして http://www.cohowinery.com/downloads 保存 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 示します。

終了 解決方法については、
ファイルをダウンロードする 方法: ファイルをダウンロードする

こちらもご覧ください

適用対象

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 -> unit
Public 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 がスラッシュで終わっています。

overwriteFalse に設定されていますが、コピー先のファイルが既に存在します。

指定した connectionTimeout 内にサーバーが応答しない場合。

ユーザーは、ネットワーク操作を実行するために必要なアクセス許可を持っていません。

要求は対象の Web サーバーで拒否されました。

この例では、ファイル WineList.txt をダウンロードして http://www.cohowinery.com/downloads 保存します 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")

この例では、ファイル WineList.txt をダウンロードして http://www.cohowinery.com/downloads 保存 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 示します。

終了 解決方法については、
ファイルをダウンロードする 方法: ファイルをダウンロードする

こちらもご覧ください

適用対象

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 -> unit
Public 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

ShowUITrue に設定された場合に表示されるダイアログ ボックスで、ユーザーが [キャンセル] または [いいえ] をクリックしたときの動作を指定します。 既定値は ThrowException です。

例外

destinationFileName がスラッシュで終わっています。

overwriteFalse に設定されていますが、コピー先のファイルが既に存在します。

指定した connectionTimeout 内にサーバーが応答しない場合。

ユーザーは、ネットワーク操作を実行するために必要なアクセス許可を持っていません。

要求は対象の Web サーバーで拒否されました。

この例では、ファイル WineList.txt をダウンロードして http://www.cohowinery.com/downloads 保存します 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")

この例では、ファイル WineList.txt をダウンロードして http://www.cohowinery.com/downloads 保存 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 示します。

終了 解決方法については、
ファイルをダウンロードする 方法: ファイルをダウンロードする

こちらもご覧ください

適用対象

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 -> unit
Public 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

ShowUITrue に設定された場合に表示されるダイアログ ボックスで、ユーザーが [キャンセル] または [いいえ] をクリックしたときの動作を指定します。 既定値は ThrowException です。

例外

destinationFileName がスラッシュで終わっています。

overwriteFalse に設定されていますが、コピー先のファイルが既に存在します。

指定した connectionTimeout 内にサーバーが応答しない場合。

ユーザーは、ネットワーク操作を実行するために必要なアクセス許可を持っていません。

要求は対象の Web サーバーで拒否されました。

この例では、ファイルWineList.txt``http://www.cohowinery.com/downloadsをダウンロードして保存します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")

次の使用例は、ファイル WineList.txt をダウンロードして http://www.cohowinery.com/downloads 保存 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 示します。

終了 解決方法については、
ファイルをダウンロードする 方法: ファイルをダウンロードする

こちらもご覧ください

適用対象