WebClient.UploadFile WebClient.UploadFile WebClient.UploadFile WebClient.UploadFile Method

定義

指定した URI を持つリソースへローカル ファイルをアップロードします。Uploads a local file to a resource with the specified URI.

オーバーロード

UploadFile(String, String) UploadFile(String, String) UploadFile(String, String) UploadFile(String, String)

指定した URI を持つリソースへ指定したローカル ファイルをアップロードします。Uploads the specified local file to a resource with the specified URI.

UploadFile(Uri, String) UploadFile(Uri, String) UploadFile(Uri, String) UploadFile(Uri, String)

指定した URI を持つリソースへ指定したローカル ファイルをアップロードします。Uploads the specified local file to a resource with the specified URI.

UploadFile(String, String, String) UploadFile(String, String, String) UploadFile(String, String, String) UploadFile(String, String, String)

指定したメソッドを使用して、指定したリソースに指定したローカル ファイルをアップロードします。Uploads the specified local file to the specified resource, using the specified method.

UploadFile(Uri, String, String) UploadFile(Uri, String, String) UploadFile(Uri, String, String) UploadFile(Uri, String, String)

指定したメソッドを使用して、指定したリソースに指定したローカル ファイルをアップロードします。Uploads the specified local file to the specified resource, using the specified method.

UploadFile(String, String) UploadFile(String, String) UploadFile(String, String) UploadFile(String, String)

指定した URI を持つリソースへ指定したローカル ファイルをアップロードします。Uploads the specified local file to a resource with the specified URI.

public:
 cli::array <System::Byte> ^ UploadFile(System::String ^ address, System::String ^ fileName);
public byte[] UploadFile (string address, string fileName);
member this.UploadFile : string * string -> byte[]
Public Function UploadFile (address As String, fileName As String) As Byte()

パラメーター

address
String String String String

ファイルを受信するリソースの URI。The URI of the resource to receive the file. ftp://localhost/samplefile.txt など。For example, ftp://localhost/samplefile.txt.

fileName
String String String String

リソースに送信するファイル。The file to send to the resource. "samplefile.txt" など。For example, "samplefile.txt".

戻り値

Byte[]

リソースからの応答の本文を格納している Byte 配列。A Byte array containing the body of the response from the resource.

例外

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 が存在しません。fileName is null, is Empty, contains invalid characters, or does not exist.

または-or- ファイルのアップロード中にエラーが発生しました。An error occurred while uploading the file.

または-or- リソースをホストしているサーバーから応答がありませんでした。There was no response from the server hosting the resource.

または-or- Content-type ヘッダーが multipart で始まっています。The Content-type header begins with multipart.

次のコード例を使用して指定された URI に指定されたファイルをアップロードするUploadFileします。The following code example uploads the specified file to the specified URI using UploadFile. サーバーによって返されるすべての応答がコンソールに表示されます。Any response returned by the server is displayed on the console.

Console::Write( "\nPlease enter the URI to post data to : " );
String^ uriString = Console::ReadLine();

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
Console::WriteLine( "\nPlease enter the fully qualified path of the file to be uploaded to the URI" );
String^ fileName = Console::ReadLine();
Console::WriteLine( "Uploading {0} to {1} ...", fileName, uriString );

// Upload the file to the URI.
// The 'UploadFile(uriString, fileName)' method implicitly uses HTTP POST method.
array<Byte>^responseArray = myWebClient->UploadFile( uriString, fileName );

// Decode and display the response.
Console::WriteLine( "\nResponse Received::The contents of the file uploaded are: \n {0}", 
    System::Text::Encoding::ASCII->GetString( responseArray ) );
Console.Write("\nPlease enter the URI to post data to : ");
String uriString = Console.ReadLine();

// Create a new WebClient instance.
WebClient myWebClient = new WebClient();

Console.WriteLine("\nPlease enter the fully qualified path of the file to be uploaded to the URI");
string fileName = Console.ReadLine();
Console.WriteLine("Uploading {0} to {1} ...",fileName,uriString);

// Upload the file to the URI.
// The 'UploadFile(uriString,fileName)' method implicitly uses HTTP POST method.
byte[] responseArray = myWebClient.UploadFile(uriString,fileName);

// Decode and display the response.
Console.WriteLine("\nResponse Received.The contents of the file uploaded are:\n{0}", 
    System.Text.Encoding.ASCII.GetString(responseArray));

Console.Write(ControlChars.Cr + "Please enter the URI to post data to : ")
Dim uriString As String = Console.ReadLine()

' Create a new WebClient instance.
Dim myWebClient As New WebClient()

Console.WriteLine(ControlChars.Cr & _
    "Please enter the fully qualified path of the file to be uploaded to the URI")

Dim fileName As String = Console.ReadLine()
Console.WriteLine("Uploading {0} to {1} ...", fileName, uriString)

' Upload the file to the URI.
' The 'UploadFile(uriString,fileName)' method implicitly uses HTTP POST method. 
Dim responseArray As Byte() = myWebClient.UploadFile(uriString, fileName)

' Decode and display the response.
Console.WriteLine(ControlChars.Cr & "Response Received.The contents of the file uploaded are: " & _
    ControlChars.Cr & "{0}", System.Text.Encoding.ASCII.GetString(responseArray))

次のコード例がポストされたファイルを受け入れることができる、ASP.NET ページを表示しで使用に適しています、UploadFileメソッド。The following code example shows an ASP.NET page that can accept posted files and is suitable for use with the UploadFile method. ページは、Web サーバー上に存在する必要があります。The page must reside on a Web server. そのアドレスの値を提供する、addressのパラメーター、UploadFileメソッド。Its address provides the value for the address parameter of the UploadFile method.

<%@ Import Namespace="System"%>
<%@ Import Namespace="System.IO"%>
<%@ Import Namespace="System.Net"%>
<%@ Import NameSpace="System.Web"%>

<Script language="C#" runat=server>
void Page_Load(object sender, EventArgs e) {
	
	foreach(string f in Request.Files.AllKeys) {
		HttpPostedFile file = Request.Files[f];
		file.SaveAs("c:\\inetpub\\test\\UploadedFiles\\" + file.FileName);
	}	
}

</Script>
<html>
<body>
<p> Upload complete.  </p>
</body>
</html>
<%@ Import Namespace="System"%>
<%@ Import Namespace="System.IO"%>
<%@ Import Namespace="System.Net"%>
<%@ Import NameSpace="System.Web"%>

<Script language="VB" runat=server>
    Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
        
        Dim f As String
        Dim file
        For Each f In Request.Files.AllKeys
            file = Request.Files(f)
            file.SaveAs("c:\inetpub\test\UploadedFiles\" & file.FileName)
        Next f
        
    End Sub

</Script>
<html>
<body>
<p> Upload complete. </p>
</body>
</html>

注釈

UploadFileメソッドは、ローカル ファイルをリソースに送信します。The UploadFile method sends a local file to a resource. このメソッドは、FTP リソースをアップロードするのに STOR コマンドを使用します。This method uses the STOR command to upload an FTP resource. HTTP リソースでは、POST メソッドを使用します。For an HTTP resource, the POST method is used.

ファイルのアップロード中に、このメソッドはブロックします。This method blocks while uploading the file. サーバーの応答の待機中に実行を続行するには、いずれかを使用、UploadFileAsyncメソッド。To continue executing while waiting for the server's response, use one of the UploadFileAsync methods.

POSTメソッドは、HTTP によって定義されます。The POST method is defined by HTTP. 基になる要求が HTTP を使用しない場合、POSTが認識されないサーバーによって、基になるプロトコル クラスが発生する内容を決定します。If the underlying request does not use HTTP and POST is not understood by the server, the underlying protocol classes determine what occurs. 通常、WebExceptionがスローされ、Statusプロパティをエラーを示す設定。Typically, a WebException is thrown with the Status property set to indicate the error.

場合、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.

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。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.

セキュリティ

FileIOPermission
ローカル ファイルにアクセスします。to access the local file. Read (関連する列挙体)Associated enumeration: Read.

UploadFile(Uri, String) UploadFile(Uri, String) UploadFile(Uri, String) UploadFile(Uri, String)

指定した URI を持つリソースへ指定したローカル ファイルをアップロードします。Uploads the specified local file to a resource with the specified URI.

public:
 cli::array <System::Byte> ^ UploadFile(Uri ^ address, System::String ^ fileName);
public byte[] UploadFile (Uri address, string fileName);
member this.UploadFile : Uri * string -> byte[]
Public Function UploadFile (address As Uri, fileName As String) As Byte()

パラメーター

address
Uri Uri Uri Uri

ファイルを受信するリソースの URI。The URI of the resource to receive the file. ftp://localhost/samplefile.txt など。For example, ftp://localhost/samplefile.txt.

fileName
String String String String

リソースに送信するファイル。The file to send to the resource. "samplefile.txt" など。For example, "samplefile.txt".

戻り値

Byte[]

リソースからの応答の本文を格納している Byte 配列。A Byte array containing the body of the response from the resource.

例外

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 が存在しません。fileName is null, is Empty, contains invalid characters, or does not exist.

または-or- ファイルのアップロード中にエラーが発生しました。An error occurred while uploading the file.

または-or- リソースをホストしているサーバーから応答がありませんでした。There was no response from the server hosting the resource.

または-or- Content-type ヘッダーが multipart で始まっています。The Content-type header begins with multipart.

注釈

UploadFileメソッドは、ローカル ファイルをリソースに送信します。The UploadFile method sends a local file to a resource. このメソッドは、FTP リソースをアップロードするのに STOR コマンドを使用します。This method uses the STOR command to upload an FTP resource. HTTP リソースでは、POST メソッドを使用します。For an HTTP resource, the POST method is used.

ファイルのアップロード中に、このメソッドはブロックします。This method blocks while uploading the file. サーバーの応答の待機中に実行を続行するには、いずれかを使用、UploadFileAsyncメソッド。To continue executing while waiting for the server's response, use one of the UploadFileAsync methods.

POSTメソッドは、HTTP によって定義されます。The POST method is defined by HTTP. 基になる要求が HTTP を使用しない場合、POSTが認識されないサーバーによって、基になるプロトコル クラスが発生する内容を決定します。If the underlying request does not use HTTP and POST is not understood by the server, the underlying protocol classes determine what occurs. 通常、WebExceptionがスローされ、Statusプロパティをエラーを示す設定。Typically, a WebException is thrown with the Status property set to indicate the error.

場合、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.

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。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.

セキュリティ

FileIOPermission
ローカル ファイルにアクセスします。to access the local file. Read (関連する列挙体)Associated enumeration: Read.

UploadFile(String, String, String) UploadFile(String, String, String) UploadFile(String, String, String) UploadFile(String, String, String)

指定したメソッドを使用して、指定したリソースに指定したローカル ファイルをアップロードします。Uploads the specified local file to the specified resource, using the specified method.

public:
 cli::array <System::Byte> ^ UploadFile(System::String ^ address, System::String ^ method, System::String ^ fileName);
public byte[] UploadFile (string address, string method, string fileName);
member this.UploadFile : string * string * string -> byte[]
Public Function UploadFile (address As String, method As String, fileName As String) As Byte()

パラメーター

address
String String String String

ファイルを受信するリソースの URI。The URI of the resource to receive the file.

method
String String String String

リソースにファイルを送信するために使用するメソッド。The method used to send the file to the resource. null の場合、http の既定値は POST、ftp の既定値は STOR です。If null, the default is POST for http and STOR for ftp.

fileName
String String String String

リソースに送信するファイル。The file to send to the resource.

戻り値

Byte[]

リソースからの応答の本文を格納している Byte 配列。A Byte array containing the body of the response from the resource.

例外

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 が存在しません。fileName is null, is Empty, contains invalid characters, or does not exist.

または-or- ファイルのアップロード中にエラーが発生しました。An error occurred while uploading the file.

または-or- リソースをホストしているサーバーから応答がありませんでした。There was no response from the server hosting the resource.

または-or- Content-type ヘッダーが multipart で始まっています。The Content-type header begins with multipart.

次のコード例を使用して指定された URI に指定されたファイルをアップロードするUploadFileします。The following code example uploads the specified file to the specified URI using UploadFile. サーバーによって返されるすべての応答がコンソールに表示されます。Any response returned by the server is displayed on the console.

Console::Write( "\nPlease enter the URL to post data to : " );
String^ uriString = Console::ReadLine();

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
Console::WriteLine
    ("\nPlease enter the fully qualified path of the file to be uploaded to the URL" );
String^ fileName = Console::ReadLine();
Console::WriteLine( "Uploading {0} to {1} ...", fileName, uriString );

// Upload the file to the URL using the HTTP 1.0 POST.
array<Byte>^responseArray = myWebClient->UploadFile( uriString, "POST", fileName );

// Decode and display the response.
Console::WriteLine( "\nResponse Received::The contents of the file uploaded are: \n {0}", 
    System::Text::Encoding::ASCII->GetString( responseArray ));
Console.Write("\nPlease enter the URL to post data to : ");
String uriString = Console.ReadLine();

// Create a new WebClient instance.
WebClient myWebClient = new WebClient();

Console.WriteLine("\nPlease enter the fully qualified path of the file to be uploaded to the URL");
string fileName = Console.ReadLine();

Console.WriteLine("Uploading {0} to {1} ...",fileName,uriString);						
// Upload the file to the URL using the HTTP 1.0 POST.
byte[] responseArray = myWebClient.UploadFile(uriString,"POST",fileName);

// Decode and display the response.
Console.WriteLine("\nResponse Received.The contents of the file uploaded are:\n{0}",
    System.Text.Encoding.ASCII.GetString(responseArray));


Console.Write(ControlChars.Cr + "Please enter the URL to post data to : ")
Dim uriString As String = Console.ReadLine()

' Create a new WebClient instance.
Dim myWebClient As New WebClient()
Console.WriteLine(ControlChars.Cr & _
    "Please enter the fully qualified path of the file to be uploaded to the URL")

Dim fileName As String = Console.ReadLine()
Console.WriteLine("Uploading {0} to {1} ...", fileName, uriString)

' Upload the file to the Url using the HTTP 1.0 POST.
Dim responseArray As Byte() = myWebClient.UploadFile(uriString, "POST", fileName)

' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response Received.The contents of the file uploaded are: " & _
    ControlChars.Cr & "{0}", System.Text.Encoding.ASCII.GetString(responseArray))

次のコード例がポストされたファイルを受け入れることができる、ASP.NET ページを表示しで使用に適しています、UploadFileメソッド。The following code example shows an ASP.NET page that can accept posted files and is suitable for use with the UploadFile method. ページは、Web サーバー上に存在する必要があります。The page must reside on a Web server. そのアドレスの値を提供する、addressのパラメーター、UploadFileメソッド。Its address provides the value for the address parameter of the UploadFile method.

<%@ Import Namespace="System"%>
<%@ Import Namespace="System.IO"%>
<%@ Import Namespace="System.Net"%>
<%@ Import NameSpace="System.Web"%>

<Script language="C#" runat=server>
void Page_Load(object sender, EventArgs e) {
	
	foreach(string f in Request.Files.AllKeys) {
		HttpPostedFile file = Request.Files[f];
		file.SaveAs("c:\\inetpub\\test\\UploadedFiles\\" + file.FileName);
	}	
}

</Script>
<html>
<body>
<p> Upload complete.  </p>
</body>
</html>
<%@ Import Namespace="System"%>
<%@ Import Namespace="System.IO"%>
<%@ Import Namespace="System.Net"%>
<%@ Import NameSpace="System.Web"%>

<Script language="VB" runat=server>
    Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
        
        Dim f As String
        Dim file
        For Each f In Request.Files.AllKeys
            file = Request.Files(f)
            file.SaveAs("c:\inetpub\test\UploadedFiles\" & file.FileName)
        Next f
        
    End Sub

</Script>
<html>
<body>
<p> Upload complete. </p>
</body>
</html>

注釈

アドレスは、HTTP リソースを指定する場合、UploadFileメソッドで指定された HTTP メソッドを使用してリソースにローカル ファイルを送信する、methodパラメーターをサーバーからの応答を返します。When address specifies an HTTP resource, the UploadFile method sends a local file to a resource using the HTTP method specified in the method parameter and returns any response from the server. ファイルのアップロード中に、このメソッドはブロックします。This method blocks while uploading the file. サーバーの応答の待機中に実行を続行するには、いずれかを使用、UploadFileAsyncメソッド。To continue executing while waiting for the server's response, use one of the UploadFileAsync methods.

場合、methodパラメーター指定の動詞がサーバーで認識されませんが、またはaddressリソース、基になるプロトコル クラスが発生する内容を決定します。If the method parameter specifies a verb that is not understood by the server or the address resource, the underlying protocol classes determine what occurs. 通常、WebExceptionがスローされ、Statusプロパティをエラーを示す設定。Typically, a WebException is thrown with the Status property set to indicate the error.

場合、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.

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。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.

セキュリティ

FileIOPermission
ローカル ファイルにアクセスします。to access the local file. 関連付けられた列挙体。 ReadAssociated enumeration: Read

UploadFile(Uri, String, String) UploadFile(Uri, String, String) UploadFile(Uri, String, String) UploadFile(Uri, String, String)

指定したメソッドを使用して、指定したリソースに指定したローカル ファイルをアップロードします。Uploads the specified local file to the specified resource, using the specified method.

public:
 cli::array <System::Byte> ^ UploadFile(Uri ^ address, System::String ^ method, System::String ^ fileName);
public byte[] UploadFile (Uri address, string method, string fileName);
member this.UploadFile : Uri * string * string -> byte[]
Public Function UploadFile (address As Uri, method As String, fileName As String) As Byte()

パラメーター

address
Uri Uri Uri Uri

ファイルを受信するリソースの URI。The URI of the resource to receive the file.

method
String String String String

リソースにファイルを送信するために使用するメソッド。The method used to send the file to the resource. null の場合、http の既定値は POST、ftp の既定値は STOR です。If null, the default is POST for http and STOR for ftp.

fileName
String String String String

リソースに送信するファイル。The file to send to the resource.

戻り値

Byte[]

リソースからの応答の本文を格納している Byte 配列。A Byte array containing the body of the response from the resource.

例外

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 が存在しません。fileName is null, is Empty, contains invalid characters, or does not exist.

または-or- ファイルのアップロード中にエラーが発生しました。An error occurred while uploading the file.

または-or- リソースをホストしているサーバーから応答がありませんでした。There was no response from the server hosting the resource.

または-or- Content-type ヘッダーが multipart で始まっています。The Content-type header begins with multipart.

注釈

アドレスは、HTTP リソースを指定する場合、UploadFileメソッドで指定された HTTP メソッドを使用してリソースにローカル ファイルを送信する、methodパラメーターをサーバーからの応答を返します。When address specifies an HTTP resource, the UploadFile method sends a local file to a resource using the HTTP method specified in the method parameter and returns any response from the server. ファイルのアップロード中に、このメソッドはブロックします。This method blocks while uploading the file. サーバーの応答の待機中に実行を続行するには、いずれかを使用、UploadFileAsyncメソッド。To continue executing while waiting for the server's response, use one of the UploadFileAsync methods.

場合、methodパラメーター指定の動詞がサーバーで認識されませんが、またはaddressリソース、基になるプロトコル クラスが発生する内容を決定します。If the method parameter specifies a verb that is not understood by the server or the address resource, the underlying protocol classes determine what occurs. 通常、WebExceptionがスローされ、Statusプロパティをエラーを示す設定。Typically, a WebException is thrown with the Status property set to indicate the error.

場合、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.

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。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.

セキュリティ

FileIOPermission
ローカル ファイルにアクセスします。to access the local file. 関連付けられた列挙体。 ReadAssociated enumeration: Read

適用対象