WebClient.UploadValuesTaskAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
タスク オブジェクトを使用した非同期操作として指定した 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
- ソース:
- WebClient.cs
- ソース:
- 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);
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。
- method
- String
リソースにコレクションを送信するために使用する HTTP メソッド。 null の場合、http の既定値は POST、ftp の既定値は STOR です。
- data
- NameValueCollection
リソースに送信する NameValueCollection。
戻り値
非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、サーバーから送信された応答を含む Byte 配列を返します。
- 属性
例外
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
- ソース:
- WebClient.cs
- ソース:
- 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);
[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。
- data
- NameValueCollection
リソースに送信する NameValueCollection。
戻り値
非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、サーバーから送信された応答を含む Byte 配列を返します。
- 属性
例外
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
- ソース:
- WebClient.cs
- ソース:
- 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);
[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。
- data
- NameValueCollection
リソースに送信する NameValueCollection。
戻り値
非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、サーバーから送信された応答を含む Byte 配列を返します。
- 属性
例外
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
- ソース:
- WebClient.cs
- ソース:
- 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);
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。
- method
- String
リソースにコレクションを送信するために使用する HTTP メソッド。 null の場合、http の既定値は POST、ftp の既定値は STOR です。
- data
- NameValueCollection
リソースに送信する NameValueCollection。
戻り値
非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、サーバーから送信された応答を含む Byte 配列を返します。
- 属性
例外
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のネットワーク トレース」を参照してください。
適用対象
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示