WebClient.UploadFileTaskAsync メソッド

定義

タスク オブジェクトを使用した非同期操作として指定されたローカル ファイルをリソースにアップロードします。Uploads the specified local file to a resource as an asynchronous operation using a task object. これらのメソッドは、呼び出し元のスレッドをブロックしません。These methods do not block the calling thread.

オーバーロード

UploadFileTaskAsync(Uri, String, String)

タスク オブジェクトを使用した非同期操作として指定されたローカル ファイルをリソースにアップロードします。Uploads the specified local file to a resource as an asynchronous operation using a task object.

UploadFileTaskAsync(String, String, String)

タスク オブジェクトを使用した非同期操作として指定されたローカル ファイルをリソースにアップロードします。Uploads the specified local file to a resource as an asynchronous operation using a task object.

UploadFileTaskAsync(String, String)

タスク オブジェクトを使用した非同期操作として指定されたローカル ファイルをリソースにアップロードします。Uploads the specified local file to a resource as an asynchronous operation using a task object.

UploadFileTaskAsync(Uri, String)

タスク オブジェクトを使用した非同期操作として指定されたローカル ファイルをリソースにアップロードします。Uploads the specified local file to a resource as an asynchronous operation using a task object.

UploadFileTaskAsync(Uri, String, String)

タスク オブジェクトを使用した非同期操作として指定されたローカル ファイルをリソースにアップロードします。Uploads the specified local file to a resource as an asynchronous operation using a task object.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(Uri ^ address, System::String ^ method, System::String ^ fileName);
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (Uri address, string? method, string fileName);
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (Uri address, string method, string fileName);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (Uri address, string method, string fileName);
member this.UploadFileTaskAsync : Uri * string * string -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadFileTaskAsync : Uri * string * string -> System.Threading.Tasks.Task<byte[]>
Public Function UploadFileTaskAsync (address As Uri, method As String, fileName As String) As Task(Of Byte())

パラメーター

address
Uri

ファイルを受信するリソースの URI。The URI of the resource to receive the file. HTTP リソースの場合、この URI は POST メソッドを使用して送信される要求を受け入れることができるリソース (スクリプトや ASP ページなど) を識別するものであることが必要です。For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

method
String

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

fileName
String

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

戻り値

Task<Byte[]>

非同期操作を表すタスク オブジェクト。The task object representing the asynchronous operation. タスク オブジェクトの Result プロパティが、ファイルがアップロードされたときにリソースから受け取った応答本体を含む Byte 配列を返します。The Result property on the task object returns a Byte array containing the body of the response received from the resource when the file was uploaded.

属性

例外

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, is Empty, contains invalid character, or the specified path to the file does not exist.

- または --or-

ストリームのオープン中にエラーが発生しました。An error occurred while opening the stream.

- または --or-

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

- または --or-

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

注釈

この操作はブロックされません。This operation will not block. 返されたオブジェクトは、 Task<TResult> ファイルがリソースにアップロードされた後に完了します。The returned Task<TResult> object will complete after the file has been uploaded to the resource. このファイルは、スレッドプールから自動的に割り当てられたスレッドリソースを使用して非同期的に送信されます。The file is sent asynchronously using thread resources that are automatically allocated from the thread pool.

.NET Framework と .NET Core 1.0 では、メソッドを呼び出して、完了していない非同期操作を取り消すことができ CancelAsync ます。In .NET Framework and .NET Core 1.0, you can cancel asynchronous operations that have not completed by calling the CancelAsync method.

BaseAddressプロパティが空の文字列 ("") でない場合、は、 address BaseAddress 要求されたデータの絶対 uri を形成するためにと組み合わせた相対 uri である必要があります。If the BaseAddress property is not an empty string (""), 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.

既定では、このメソッドは、STOR コマンドを使用して FTP リソースをアップロードします。BY default, this method uses the STOR command to upload an FTP resource. HTTP リソースの場合は、POST メソッドが使用されます。For an HTTP resource, the POST 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 .NET Framework.

適用対象

UploadFileTaskAsync(String, String, String)

タスク オブジェクトを使用した非同期操作として指定されたローカル ファイルをリソースにアップロードします。Uploads the specified local file to a resource as an asynchronous operation using a task object.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(System::String ^ address, System::String ^ method, System::String ^ fileName);
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (string address, string? method, string fileName);
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (string address, string method, string fileName);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (string address, string method, string fileName);
member this.UploadFileTaskAsync : string * string * string -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadFileTaskAsync : string * string * string -> System.Threading.Tasks.Task<byte[]>
Public Function UploadFileTaskAsync (address As String, method As String, fileName As String) As Task(Of Byte())

パラメーター

address
String

ファイルを受信するリソースの URI。The URI of the resource to receive the file. HTTP リソースの場合、この URI は POST メソッドを使用して送信される要求を受け入れることができるリソース (スクリプトや ASP ページなど) を識別するものであることが必要です。For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

method
String

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

fileName
String

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

戻り値

Task<Byte[]>

非同期操作を表すタスク オブジェクト。The task object representing the asynchronous operation. タスク オブジェクトの Result プロパティが、ファイルがアップロードされたときにリソースから受け取った応答本体を含む Byte 配列を返します。The Result property on the task object returns a Byte array containing the body of the response received from the resource when the file was uploaded.

属性

例外

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, is Empty, contains invalid character, or the specified path to the file does not exist.

- または --or-

ストリームのオープン中にエラーが発生しました。An error occurred while opening the stream.

- または --or-

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

- または --or-

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

注釈

この操作はブロックされません。This operation will not block. 返されたオブジェクトは、 Task<TResult> ファイルがリソースにアップロードされた後に完了します。The returned Task<TResult> object will complete after the file has been uploaded to the resource. このファイルは、スレッドプールから自動的に割り当てられたスレッドリソースを使用して非同期的に送信されます。The file is sent asynchronously using thread resources that are automatically allocated from the thread pool.

.NET Framework と .NET Core 1.0 では、メソッドを呼び出して、完了していない非同期操作を取り消すことができ CancelAsync ます。In .NET Framework and .NET Core 1.0, you can cancel asynchronous operations that have not completed by calling the CancelAsync method.

BaseAddressプロパティが空の文字列 ("") でない場合、は、 address BaseAddress 要求されたデータの絶対 uri を形成するためにと組み合わせた相対 uri である必要があります。If the BaseAddress property is not an empty string (""), 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.

既定では、このメソッドは、STOR コマンドを使用して FTP リソースをアップロードします。BY default, this method uses the STOR command to upload an FTP resource. HTTP リソースの場合は、POST メソッドが使用されます。For an HTTP resource, the POST 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 .NET Framework.

適用対象

UploadFileTaskAsync(String, String)

タスク オブジェクトを使用した非同期操作として指定されたローカル ファイルをリソースにアップロードします。Uploads the specified local file to a resource as an asynchronous operation using a task object.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(System::String ^ address, System::String ^ fileName);
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (string address, string fileName);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (string address, string fileName);
member this.UploadFileTaskAsync : string * string -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadFileTaskAsync : string * string -> System.Threading.Tasks.Task<byte[]>
Public Function UploadFileTaskAsync (address As String, fileName As String) As Task(Of Byte())

パラメーター

address
String

ファイルを受信するリソースの URI。The URI of the resource to receive the file. HTTP リソースの場合、この URI は POST メソッドを使用して送信される要求を受け入れることができるリソース (スクリプトや ASP ページなど) を識別するものであることが必要です。For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

fileName
String

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

戻り値

Task<Byte[]>

非同期操作を表すタスク オブジェクト。The task object representing the asynchronous operation. タスク オブジェクトの Result プロパティが、ファイルがアップロードされたときにリソースから受け取った応答本体を含む Byte 配列を返します。The Result property on the task object returns a Byte array containing the body of the response received from the resource when the file was uploaded.

属性

例外

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, is Empty, contains invalid character, or the specified path to the file does not exist.

- または --or-

ストリームのオープン中にエラーが発生しました。An error occurred while opening the stream.

- または --or-

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

- または --or-

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

注釈

この操作はブロックされません。This operation will not block. 返されたオブジェクトは、 Task<TResult> ファイルがリソースにアップロードされた後に完了します。The returned Task<TResult> object will complete after the file has been uploaded to the resource. このファイルは、スレッドプールから自動的に割り当てられたスレッドリソースを使用して非同期的に送信されます。The file is sent asynchronously using thread resources that are automatically allocated from the thread pool.

.NET Framework と .NET Core 1.0 では、メソッドを呼び出して、完了していない非同期操作を取り消すことができ CancelAsync ます。In .NET Framework and .NET Core 1.0, you can cancel asynchronous operations that have not completed by calling the CancelAsync method.

BaseAddressプロパティが空の文字列 ("") でない場合、は、 address BaseAddress 要求されたデータの絶対 uri を形成するためにと組み合わせた相対 uri である必要があります。If the BaseAddress property is not an empty string (""), 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.

このメソッドでは、STOR コマンドを使用して FTP リソースをアップロードします。This method uses the STOR command to upload an FTP resource. HTTP リソースの場合は、POST メソッドが使用されます。For an HTTP resource, the POST 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 .NET Framework.

適用対象

UploadFileTaskAsync(Uri, String)

タスク オブジェクトを使用した非同期操作として指定されたローカル ファイルをリソースにアップロードします。Uploads the specified local file to a resource as an asynchronous operation using a task object.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(Uri ^ address, System::String ^ fileName);
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (Uri address, string fileName);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (Uri address, string fileName);
member this.UploadFileTaskAsync : Uri * string -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadFileTaskAsync : Uri * string -> System.Threading.Tasks.Task<byte[]>
Public Function UploadFileTaskAsync (address As Uri, fileName As String) As Task(Of Byte())

パラメーター

address
Uri

ファイルを受信するリソースの URI。The URI of the resource to receive the file. HTTP リソースの場合、この URI は POST メソッドを使用して送信される要求を受け入れることができるリソース (スクリプトや ASP ページなど) を識別するものであることが必要です。For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

fileName
String

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

戻り値

Task<Byte[]>

非同期操作を表すタスク オブジェクト。The task object representing the asynchronous operation. タスク オブジェクトの Result プロパティが、ファイルがアップロードされたときにリソースから受け取った応答本体を含む Byte 配列を返します。The Result property on the task object returns a Byte array containing the body of the response received from the resource when the file was uploaded.

属性

例外

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, is Empty, contains invalid character, or the specified path to the file does not exist.

- または --or-

ストリームのオープン中にエラーが発生しました。An error occurred while opening the stream.

- または --or-

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

- または --or-

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

注釈

この操作はブロックされません。This operation will not block. 返されたオブジェクトは、 Task<TResult> ファイルがリソースにアップロードされた後に完了します。The returned Task<TResult> object will complete after the file has been uploaded to the resource. このファイルは、スレッドプールから自動的に割り当てられたスレッドリソースを使用して非同期的に送信されます。The file is sent asynchronously using thread resources that are automatically allocated from the thread pool.

.NET Framework と .NET Core 1.0 では、メソッドを呼び出して、完了していない非同期操作を取り消すことができ CancelAsync ます。In .NET Framework and .NET Core 1.0, you can cancel asynchronous operations that have not completed by calling the CancelAsync method.

BaseAddressプロパティが空の文字列 ("") でない場合、は、 address BaseAddress 要求されたデータの絶対 uri を形成するためにと組み合わせた相対 uri である必要があります。If the BaseAddress property is not an empty string (""), 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.

このメソッドでは、STOR コマンドを使用して FTP リソースをアップロードします。This method uses the STOR command to upload an FTP resource. HTTP リソースの場合は、POST メソッドが使用されます。For an HTTP resource, the POST 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 .NET Framework.

適用対象