Network.DownloadFile メソッド

定義

名前空間:

Microsoft.VisualBasic.Devices

アセンブリ:

Microsoft.VisualBasic.Forms.dll

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

オーバーロード

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

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

例外

ArgumentException

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

TimeoutException

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

SecurityException

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

WebException

要求は対象の 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 -> unit

Public Sub DownloadFile (address As Uri, destinationFileName As String)

パラメーター

address

Uri

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

destinationFileName

String

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

例外

ArgumentException

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

TimeoutException

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

SecurityException

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

WebException

要求は対象の 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 -> unit

Public Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String)

パラメーター

address

String

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

destinationFileName

String

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

userName

String

認証するユーザー名。 既定値は空の文字列 ("") です。

password

String

認証するパスワード。 既定値は空の文字列 ("") です。

例外

ArgumentException

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

TimeoutException

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

SecurityException

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

WebException

要求は対象の 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 -> unit

Public Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String)

パラメーター

address

Uri

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

destinationFileName

String

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

userName

String

認証するユーザー名。 既定値は空の文字列 ("") です。

password

String

認証するパスワード。 既定値は空の文字列 ("") です。

例外

ArgumentException

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

TimeoutException

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

SecurityException

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

WebException

要求は対象の 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 -> 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 です。

例外

ArgumentException

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

IOException

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

TimeoutException

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

SecurityException

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

WebException

要求は対象の 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 -> 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 です。

例外

ArgumentException

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

IOException

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

TimeoutException

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

SecurityException

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

WebException

要求は対象の 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 -> 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 です。

例外

ArgumentException

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

IOException

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

TimeoutException

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

SecurityException

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

WebException

要求は対象の 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 -> 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 です。

例外

ArgumentException

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

IOException

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

TimeoutException

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

SecurityException

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

WebException

要求は対象の 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 -> 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

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

例外

ArgumentException

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

IOException

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

TimeoutException

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

SecurityException

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

WebException

要求は対象の 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 -> 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

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

例外

ArgumentException

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

IOException

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

TimeoutException

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

SecurityException

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

WebException

要求は対象の 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 でファイル パスを解析する