WebClient.UploadValuesTaskAsync メソッド

定義

タスク オブジェクトを使用した非同期操作として指定した URI で識別されるリソースに、指定した名前/値コレクションをアップロードします。Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object. これらのメソッドは、呼び出し元のスレッドをブロックしません。These methods do not block the calling thread.

オーバーロード

UploadValuesTaskAsync(String, String, NameValueCollection)

タスク オブジェクトを使用した非同期操作として指定した URI で識別されるリソースに、指定した名前/値コレクションをアップロードします。Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.

UploadValuesTaskAsync(String, NameValueCollection)

タスク オブジェクトを使用した非同期操作として指定した URI で識別されるリソースに、指定した名前/値コレクションをアップロードします。Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.

UploadValuesTaskAsync(Uri, NameValueCollection)

タスク オブジェクトを使用した非同期操作として指定した URI で識別されるリソースに、指定した名前/値コレクションをアップロードします。Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.

UploadValuesTaskAsync(Uri, String, NameValueCollection)

タスク オブジェクトを使用した非同期操作として指定した URI で識別されるリソースに、指定した名前/値コレクションをアップロードします。Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.

UploadValuesTaskAsync(String, String, NameValueCollection)

タスク オブジェクトを使用した非同期操作として指定した URI で識別されるリソースに、指定した名前/値コレクションをアップロードします。Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.

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

パラメーター

address
String

コレクションを受信するリソースの URI。The URI of the resource to receive the collection.

method
String

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

data
NameValueCollection

リソースに送信する NameValueCollectionThe NameValueCollection 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 response sent by the server.

属性

例外

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

または-or-

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

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

- または --or-

method を使用してコンテンツを送信することはできません。method cannot be used to send content.

- または --or-

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

- または --or-

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

- または --or-

Content-type ヘッダーが null または "application/x-www-form-urlencoded" ではありません。The Content-type header is not null or "application/x-www-form-urlencoded".

注釈

この操作はブロックされません。This operation will not block. 返されたオブジェクトは、 Task<TResult> 名前/値のコレクションがリソースにアップロードされた後に完了します。The returned Task<TResult> object will complete after the name/value collection has been uploaded to the resource. 名前/値のコレクションは、スレッドプールから自動的に割り当てられたスレッドリソースを使用して非同期的に送信されます。The name/value collection 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.

基になる要求がサーバーで認識されていない場合は、基になるプロトコルクラスによって何が発生するかが決まります。If the underlying request 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.

Content-type ヘッダーがの場合 null 、このメソッドはそれを "application/url エンコード" に設定します。If the Content-type header is null, this method sets it to "application/x-www-form-urlencoded".

BaseAddressプロパティが空の文字列 ("") ではなく、 address 絶対 uri も含まれていない場合、は、 address 要求された BaseAddress データの絶対 uri を形成するためにと組み合わせた相対 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.

このメソッドでは、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.

適用対象

UploadValuesTaskAsync(String, NameValueCollection)

タスク オブジェクトを使用した非同期操作として指定した URI で識別されるリソースに、指定した名前/値コレクションをアップロードします。Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.

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

パラメーター

address
String

コレクションを受信するリソースの URI。The URI of the resource to receive the collection.

data
NameValueCollection

リソースに送信する NameValueCollectionThe NameValueCollection 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 response sent by the server.

属性

例外

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

または-or-

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

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

- または --or-

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

- または --or-

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

- または --or-

Content-type ヘッダーが null または "application/x-www-form-urlencoded" ではありません。The Content-type header is not null or "application/x-www-form-urlencoded".

注釈

この操作はブロックされません。This operation will not block. 返されたオブジェクトは、 Task<TResult> 名前/値のコレクションがリソースにアップロードされた後に完了します。The returned Task<TResult> object will complete after the name/value collection has been uploaded to the resource. 名前/値のコレクションは、スレッドプールから自動的に割り当てられたスレッドリソースを使用して非同期的に送信されます。The name/value collection 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.

基になる要求がサーバーで認識されていない場合は、基になるプロトコルクラスによって何が発生するかが決まります。If the underlying request 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.

Content-type ヘッダーがの場合 null 、このメソッドはそれを "application/url エンコード" に設定します。If the Content-type header is null, this method sets it to "application/x-www-form-urlencoded".

BaseAddressプロパティが空の文字列 ("") ではなく、 address 絶対 uri も含まれていない場合、は、 address 要求された BaseAddress データの絶対 uri を形成するためにと組み合わせた相対 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.

このメソッドでは、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.

適用対象

UploadValuesTaskAsync(Uri, NameValueCollection)

タスク オブジェクトを使用した非同期操作として指定した URI で識別されるリソースに、指定した名前/値コレクションをアップロードします。Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (Uri address, System.Collections.Specialized.NameValueCollection data);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (Uri address, System.Collections.Specialized.NameValueCollection data);
member this.UploadValuesTaskAsync : Uri * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadValuesTaskAsync : Uri * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>
Public Function UploadValuesTaskAsync (address As Uri, data As NameValueCollection) As Task(Of Byte())

パラメーター

address
Uri

コレクションを受信するリソースの URI。The URI of the resource to receive the collection.

data
NameValueCollection

リソースに送信する NameValueCollectionThe NameValueCollection 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 response sent by the server.

属性

例外

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

または-or-

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

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

- または --or-

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

- または --or-

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

- または --or-

Content-type ヘッダー値が null ではなく、application/x-www-form-urlencoded でもありません。The Content-type header value is not null and is not application/x-www-form-urlencoded.

注釈

この操作はブロックされません。This operation will not block. 返されたオブジェクトは、 Task<TResult> 名前/値のコレクションがリソースにアップロードされた後に完了します。The returned Task<TResult> object will complete after the name/value collection has been uploaded to the resource. 名前/値のコレクションは、スレッドプールから自動的に割り当てられたスレッドリソースを使用して非同期的に送信されます。The name/value collection 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.

基になる要求がサーバーで認識されていない場合は、基になるプロトコルクラスによって何が発生するかが決まります。If the underlying request 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.

Content-type ヘッダーがの場合 null 、このメソッドはそれを "application/url エンコード" に設定します。If the Content-type header is null, this method sets it to "application/x-www-form-urlencoded".

BaseAddressプロパティが空の文字列 ("") ではなく、 address 絶対 uri も含まれていない場合、は、 address 要求された BaseAddress データの絶対 uri を形成するためにと組み合わせた相対 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.

このメソッドでは、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.

適用対象

UploadValuesTaskAsync(Uri, String, NameValueCollection)

タスク オブジェクトを使用した非同期操作として指定した URI で識別されるリソースに、指定した名前/値コレクションをアップロードします。Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.

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

パラメーター

address
Uri

コレクションを受信するリソースの URI。The URI of the resource to receive the collection.

method
String

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

data
NameValueCollection

リソースに送信する NameValueCollectionThe NameValueCollection 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 response sent by the server.

属性

例外

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

または-or-

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

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

- または --or-

method を使用してコンテンツを送信することはできません。method cannot be used to send content.

- または --or-

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

- または --or-

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

- または --or-

Content-type ヘッダーが null または "application/x-www-form-urlencoded" ではありません。The Content-type header is not null or "application/x-www-form-urlencoded".

注釈

この操作はブロックされません。This operation will not block. 返されたオブジェクトは、 Task<TResult> 名前/値のコレクションがリソースにアップロードされた後に完了します。The returned Task<TResult> object will complete after the name/value collection has been uploaded to the resource. 名前/値のコレクションは、スレッドプールから自動的に割り当てられたスレッドリソースを使用して非同期的に送信されます。The name/value collection 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.

基になる要求がサーバーで認識されていない場合は、基になるプロトコルクラスによって何が発生するかが決まります。If the underlying request 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.

Content-type ヘッダーがの場合 null 、このメソッドはそれを "application/url エンコード" に設定します。If the Content-type header is null, this method sets it to "application/x-www-form-urlencoded".

BaseAddressプロパティが空の文字列 ("") ではなく、 address 絶対 uri も含まれていない場合、は、 address 要求された BaseAddress データの絶対 uri を形成するためにと組み合わせた相対 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.

このメソッドでは、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.

適用対象