WebClient.UploadValuesTaskAsync メソッド

定義

名前空間:

System.Net

アセンブリ:

System.Net.WebClient.dll

タスク オブジェクトを使用した非同期操作として指定した URI で識別されるリソースに、指定した名前/値コレクションをアップロードします。 これらのメソッドは、呼び出し元のスレッドをブロックしません。

オーバーロード

UploadValuesTaskAsync(String, String, NameValueCollection)	タスク オブジェクトを使用した非同期操作として指定した URI で識別されるリソースに、指定した名前/値コレクションをアップロードします。
UploadValuesTaskAsync(String, NameValueCollection)	タスク オブジェクトを使用した非同期操作として指定した URI で識別されるリソースに、指定した名前/値コレクションをアップロードします。
UploadValuesTaskAsync(Uri, NameValueCollection)	タスク オブジェクトを使用した非同期操作として指定した URI で識別されるリソースに、指定した名前/値コレクションをアップロードします。
UploadValuesTaskAsync(Uri, String, NameValueCollection)	タスク オブジェクトを使用した非同期操作として指定した URI で識別されるリソースに、指定した名前/値コレクションをアップロードします。

UploadValuesTaskAsync(String, String, NameValueCollection)

ソース:

WebClient.cs

タスク オブジェクトを使用した非同期操作として指定した URI で識別されるリソースに、指定した名前/値コレクションをアップロードします。

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);

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。

method

String

リソースにコレクションを送信するために使用する HTTP メソッド。 null の場合、http の既定値は POST、ftp の既定値は STOR です。

data

NameValueCollection

リソースに送信する NameValueCollection。

戻り値

Task<Byte[]>

非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、サーバーから送信された応答を含む Byte 配列を返します。

例外

ArgumentNullException

address パラメーターが null です。

または

data パラメーターが null です。

WebException

BaseAddress および address を組み合わせて形成された URI が無効です。

- または -

method を使用してコンテンツを送信することはできません。

- または -

リソースをホストしているサーバーから応答がありませんでした。

- または -

ストリームのオープン中にエラーが発生しました。

- または -

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

注釈

この操作はブロックされません。 返された Task<TResult> オブジェクトは、名前/値コレクションがリソースにアップロードされた後に完了します。 名前/値のコレクションは、スレッド プールから自動的に割り当てられるスレッド リソースを使用して非同期的に送信されます。

.NET Framework および .NET Core 1.0 では、 メソッドを呼び出すことで、完了していない非同期操作をCancelAsync取り消すことができます。

基になる要求がサーバーによって認識されない場合、基になるプロトコル クラスによって何が発生するかが決まります。 通常、 WebException は、エラーを示すために プロパティが Status 設定された 状態でスローされます。

Content-type ヘッダーが の場合、このメソッドは null"application/x-www-form-urlencoded" に設定します。

プロパティが BaseAddress 空の文字列 ("") address ではなく、絶対 URI を含まない場合は、 address と組み合わせて BaseAddress 、要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが空の QueryString 文字列でない場合は、 に address追加されます。

このメソッドは、STOR コマンドを使用して FTP リソースをアップロードします。 HTTP リソースの場合は、POST メソッドが使用されます。

Note

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。

UploadValuesTaskAsync(String, NameValueCollection)

ソース:

WebClient.cs

タスク オブジェクトを使用した非同期操作として指定した URI で識別されるリソースに、指定した名前/値コレクションをアップロードします。

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);

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。

data

NameValueCollection

リソースに送信する NameValueCollection。

戻り値

Task<Byte[]>

非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、サーバーから送信された応答を含む Byte 配列を返します。

例外

ArgumentNullException

address パラメーターが null です。

または

data パラメーターが null です。

WebException

BaseAddress および address を組み合わせて形成された URI が無効です。

- または -

リソースをホストしているサーバーから応答がありませんでした。

- または -

ストリームのオープン中にエラーが発生しました。

- または -

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

注釈

この操作はブロックされません。 返された Task<TResult> オブジェクトは、名前/値コレクションがリソースにアップロードされた後に完了します。 名前/値のコレクションは、スレッド プールから自動的に割り当てられるスレッド リソースを使用して非同期的に送信されます。

.NET Framework および .NET Core 1.0 では、 メソッドを呼び出すことで、完了していない非同期操作をCancelAsync取り消すことができます。

基になる要求がサーバーによって認識されない場合、基になるプロトコル クラスによって何が発生するかが決まります。 通常、 WebException は、エラーを示すために プロパティが Status 設定された 状態でスローされます。

Content-type ヘッダーが の場合、このメソッドは null"application/x-www-form-urlencoded" に設定します。

プロパティが BaseAddress 空の文字列 ("") address ではなく、絶対 URI を含まない場合は、 address と組み合わせて BaseAddress 、要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが空の QueryString 文字列でない場合は、 に address追加されます。

このメソッドは、STOR コマンドを使用して FTP リソースをアップロードします。 HTTP リソースの場合は、POST メソッドが使用されます。

Note

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。

UploadValuesTaskAsync(Uri, NameValueCollection)

ソース:

WebClient.cs

タスク オブジェクトを使用した非同期操作として指定した URI で識別されるリソースに、指定した名前/値コレクションをアップロードします。

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);

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。

data

NameValueCollection

リソースに送信する NameValueCollection。

戻り値

Task<Byte[]>

非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、サーバーから送信された応答を含む Byte 配列を返します。

例外

ArgumentNullException

address パラメーターが null です。

または

data パラメーターが null です。

WebException

BaseAddress および address を組み合わせて形成された URI が無効です。

- または -

ストリームのオープン中にエラーが発生しました。

- または -

リソースをホストしているサーバーから応答がありませんでした。

- または -

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

注釈

この操作はブロックされません。 返された Task<TResult> オブジェクトは、名前/値コレクションがリソースにアップロードされた後に完了します。 名前/値のコレクションは、スレッド プールから自動的に割り当てられるスレッド リソースを使用して非同期的に送信されます。

.NET Framework および .NET Core 1.0 では、 メソッドを呼び出すことで、完了していない非同期操作をCancelAsync取り消すことができます。

基になる要求がサーバーによって認識されない場合、基になるプロトコル クラスによって何が発生するかが決まります。 通常、 WebException は、エラーを示すために プロパティが Status 設定された 状態でスローされます。

Content-type ヘッダーが の場合、このメソッドは null"application/x-www-form-urlencoded" に設定します。

プロパティが BaseAddress 空の文字列 ("") address ではなく、絶対 URI を含まない場合は、 address と組み合わせて BaseAddress 、要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが空の QueryString 文字列でない場合は、 に address追加されます。

このメソッドは、STOR コマンドを使用して FTP リソースをアップロードします。 HTTP リソースの場合は、POST メソッドが使用されます。

Note

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。

UploadValuesTaskAsync(Uri, String, NameValueCollection)

ソース:

WebClient.cs

タスク オブジェクトを使用した非同期操作として指定した URI で識別されるリソースに、指定した名前/値コレクションをアップロードします。

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);

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。

method

String

リソースにコレクションを送信するために使用する HTTP メソッド。 null の場合、http の既定値は POST、ftp の既定値は STOR です。

data

NameValueCollection

リソースに送信する NameValueCollection。

戻り値

Task<Byte[]>

非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、サーバーから送信された応答を含む Byte 配列を返します。

例外

ArgumentNullException

address パラメーターが null です。

または

data パラメーターが null です。

WebException

BaseAddress および address を組み合わせて形成された URI が無効です。

- または -

method を使用してコンテンツを送信することはできません。

- または -

リソースをホストしているサーバーから応答がありませんでした。

- または -

ストリームのオープン中にエラーが発生しました。

- または -

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

注釈

この操作はブロックされません。 返された Task<TResult> オブジェクトは、名前/値コレクションがリソースにアップロードされた後に完了します。 名前/値のコレクションは、スレッド プールから自動的に割り当てられるスレッド リソースを使用して非同期的に送信されます。

.NET Framework および .NET Core 1.0 では、 メソッドを呼び出すことで、完了していない非同期操作をCancelAsync取り消すことができます。

基になる要求がサーバーによって認識されない場合、基になるプロトコル クラスによって何が発生するかが決まります。 通常、 WebException は、エラーを示すために プロパティが Status 設定された 状態でスローされます。

Content-type ヘッダーが の場合、このメソッドは null"application/x-www-form-urlencoded" に設定します。

プロパティが BaseAddress 空の文字列 ("") address ではなく、絶対 URI を含まない場合は、 address と組み合わせて BaseAddress 、要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが空の QueryString 文字列でない場合は、 に address追加されます。

このメソッドは、STOR コマンドを使用して FTP リソースをアップロードします。 HTTP リソースの場合は、POST メソッドが使用されます。

Note

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。