WebClient.DownloadFile WebClient.DownloadFile WebClient.DownloadFile WebClient.DownloadFile Method

定義

指定した URI を持つリソースをローカル ファイルにダウンロードします。Downloads the resource with the specified URI to a local file.

オーバーロード

DownloadFile(Uri, String) DownloadFile(Uri, String) DownloadFile(Uri, String) DownloadFile(Uri, String)

指定した URI を持つリソースをローカル ファイルにダウンロードします。Downloads the resource with the specified URI to a local file.

DownloadFile(String, String) DownloadFile(String, String) DownloadFile(String, String) DownloadFile(String, String)

指定した URI を持つリソースをローカル ファイルにダウンロードします。Downloads the resource with the specified URI to a local file.

DownloadFile(Uri, String) DownloadFile(Uri, String) DownloadFile(Uri, String) DownloadFile(Uri, String)

指定した URI を持つリソースをローカル ファイルにダウンロードします。Downloads the resource with the specified URI to a local file.

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

パラメーター

address
Uri Uri Uri Uri

String として指定した、データのダウンロード元の URI。The URI specified as a String, from which to download data.

fileName
String String String String

データを受信するローカル ファイルの名前。The name of the local file that is to receive the data.

例外

address パラメーターが null です。The address parameter is null.

または-or- fileName パラメーターが null です。The fileName parameter is null.

BaseAddress および address を組み合わせて形成された URI が無効です。The URI formed by combining BaseAddress and address is invalid.

または-or- filenamenull または Empty です。filename is null or Empty.

または-or- ファイルが存在しません。The file does not exist.

または-or- データのダウンロード中にエラーが発生しました。An error occurred while downloading data.

このメソッドは、複数のスレッドで同時に呼び出されています。The method has been called simultaneously on multiple threads.

注釈

DownloadFileメソッドがで指定された URI からローカル ファイルのデータをダウンロード、addressパラメーター。The DownloadFile method downloads to a local file data from the URI specified by in the address parameter. リソースのダウンロード中に、このメソッドはブロックします。This method blocks while downloading the resource. リソースをダウンロードして、サーバーの応答の待機中に実行を継続のいずれかの操作を使用して、DownloadFileAsyncメソッド。To download a resource and continue executing while waiting for the server's response, use one of the DownloadFileAsync methods.

場合、BaseAddressプロパティは空の文字列ではありません ("") とaddress、絶対 URI が含まれていないaddressと組み合わせる相対 URI でなければなりませんBaseAddressを要求されたデータの絶対 URI を形成します。If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. 場合、QueryStringプロパティは空の文字列ではありませんに追加されますaddressします。If the QueryString property is not an empty string, it is appended to address.

このメソッドでは、RETR コマンドを使用して、FTP リソースをダウンロードします。This method uses the RETR command to download an FTP resource. HTTP リソースでは、GET メソッドを使用します。For an HTTP resource, the GET method is used.

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。This member outputs trace information when you enable network tracing in your application. 詳細については、次を参照してください。ネットワークのトレースを .NET Framework でします。For more information, see Network Tracing in the .NET Framework.

ASP.NET ページなどの中間層アプリケーションでこのメソッドを使用する場合、アプリケーションを実行するアカウントにファイルにアクセスするためのアクセス許可がない場合にエラーを受け取ります。When using this method in a middle tier application, such as an ASP.NET page, you will receive an error if the account under which the application executes does not have permission to access the file.

セキュリティ

FileIOPermission
ファイルの書き込みにfileNameします。to write the file fileName. Write (関連する列挙体)Associated enumeration: Write.

DownloadFile(String, String) DownloadFile(String, String) DownloadFile(String, String) DownloadFile(String, String)

指定した URI を持つリソースをローカル ファイルにダウンロードします。Downloads the resource with the specified URI to a local file.

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

パラメーター

address
String String String String

データのダウンロード元の URI。The URI from which to download data.

fileName
String String String String

データを受信するローカル ファイルの名前。The name of the local file that is to receive the data.

例外

address パラメーターが null です。The address parameter is null.

BaseAddress および address を組み合わせて形成された URI が無効です。The URI formed by combining BaseAddress and address is invalid.

または-or- filenamenull または Empty です。filename is null or Empty.

または-or- ファイルが存在しません。The file does not exist.

または、データのダウンロード中にエラーが発生しました。-or- An error occurred while downloading data.

このメソッドは、複数のスレッドで同時に呼び出されています。The method has been called simultaneously on multiple threads.

次のコード例からファイルをダウンロードするhttp://www.contoso.comローカル ハード ドライブにします。The following code example downloads a file from http://www.contoso.com to the local hard drive.

String^ remoteUri = "http://www.contoso.com/library/homepage/images/";
String^ fileName = "ms-banner.gif", ^myStringWebResource = nullptr;
// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
// Concatenate the domain with the Web resource filename.
myStringWebResource = String::Concat( remoteUri, fileName );
Console::WriteLine( "Downloading File \"{0}\" from \"{1}\" .......\n\n", fileName, myStringWebResource );
// Download the Web resource and save it into the current filesystem folder.
myWebClient->DownloadFile( myStringWebResource, fileName );
Console::WriteLine( "Successfully Downloaded File \"{0}\" from \"{1}\"", fileName, myStringWebResource );
Console::WriteLine( "\nDownloaded file saved in the following file system folder:\n\t {0}", Application::StartupPath );
string remoteUri = "http://www.contoso.com/library/homepage/images/";
string fileName = "ms-banner.gif", myStringWebResource = null;
// Create a new WebClient instance.
WebClient myWebClient = new WebClient();
// Concatenate the domain with the Web resource filename.
myStringWebResource = remoteUri + fileName;
Console.WriteLine("Downloading File \"{0}\" from \"{1}\" .......\n\n", fileName, myStringWebResource);
// Download the Web resource and save it into the current filesystem folder.
myWebClient.DownloadFile(myStringWebResource,fileName);		
Console.WriteLine("Successfully Downloaded File \"{0}\" from \"{1}\"", fileName, myStringWebResource);
Console.WriteLine("\nDownloaded file saved in the following file system folder:\n\t" + Application.StartupPath);
Dim remoteUri As String = "http://www.contoso.com/library/homepage/images/"
Dim fileName As String = "ms-banner.gif"
Dim myStringWebResource As String = Nothing
' Create a new WebClient instance.
Dim myWebClient As New WebClient()
' Concatenate the domain with the Web resource filename. Because DownloadFile 
'requires a fully qualified resource name, concatenate the domain with the Web resource file name.
myStringWebResource = remoteUri + fileName
Console.WriteLine("Downloading File ""{0}"" from ""{1}"" ......." + ControlChars.Cr + ControlChars.Cr, fileName, myStringWebResource)
' The DownloadFile() method downloads the Web resource and saves it into the current file-system folder.
myWebClient.DownloadFile(myStringWebResource, fileName)
Console.WriteLine("Successfully Downloaded file ""{0}"" from ""{1}""", fileName, myStringWebResource)
Console.WriteLine((ControlChars.Cr + "Downloaded file saved in the following file system folder:" + ControlChars.Cr + ControlChars.Tab + Application.StartupPath))

注釈

DownloadFileメソッドがで指定された URI からローカル ファイルのデータをダウンロード、addressパラメーター。The DownloadFile method downloads to a local file data from the URI specified by in the address parameter. リソースのダウンロード中に、このメソッドはブロックします。This method blocks while downloading the resource. リソースをダウンロードして、サーバーの応答の待機中に実行を継続のいずれかの操作を使用して、DownloadFileAsyncメソッド。To download a resource and continue executing while waiting for the server's response, use one of the DownloadFileAsync methods.

場合、BaseAddressプロパティは空の文字列ではありません ("") とaddress、絶対 URI が含まれていないaddressと組み合わせる相対 URI でなければなりませんBaseAddressを要求されたデータの絶対 URI を形成します。If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. 場合、QueryStringプロパティは空の文字列ではありませんに追加されますaddressします。If the QueryString property is not an empty string, it is appended to address.

このメソッドでは、RETR コマンドを使用して、FTP リソースをダウンロードします。This method uses the RETR command to download an FTP resource. HTTP リソースでは、GET メソッドを使用します。For an HTTP resource, the GET method is used.

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。This member outputs trace information when you enable network tracing in your application. 詳細については、次を参照してください。ネットワークのトレースを .NET Framework でします。For more information, see Network Tracing in the .NET Framework.

ASP.NET ページなどの中間層アプリケーションでこのメソッドを使用する場合、アプリケーションを実行するアカウントにファイルにアクセスするためのアクセス許可がない場合にエラーを受け取ります。When using this method in a middle tier application, such as an ASP.NET page, you will receive an error if the account under which the application executes does not have permission to access the file.

セキュリティ

FileIOPermission
ファイルの書き込みにfileNameします。to write the file fileName. Write (関連する列挙体)Associated enumeration: Write.

適用対象