WebClient.UploadValuesAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定した URI で識別されるリソースに指定した名前/値コレクションをアップロードします。 これらのメソッドは、呼び出し元のスレッドをブロックしません。
オーバーロード
UploadValuesAsync(Uri, NameValueCollection) |
指定した URI で識別されるリソースに指定した名前/値コレクションのデータをアップロードします。 このメソッドは、呼び出し元のスレッドをブロックしません。 |
UploadValuesAsync(Uri, String, NameValueCollection) |
指定したメソッドを使用して、指定した URI で識別されるリソースに、指定した名前/値コレクションのデータをアップロードします。 このメソッドは、呼び出し元のスレッドをブロックしません。 |
UploadValuesAsync(Uri, String, NameValueCollection, Object) |
指定したメソッドを使用して、指定した URI で識別されるリソースに、指定した名前/値コレクションのデータをアップロードします。 このメソッドは、呼び出し元のスレッドをブロックしません。また、呼び出し元は、操作の完了時に呼び出されるメソッドにオブジェクトを渡すことができます。 |
UploadValuesAsync(Uri, NameValueCollection)
- ソース:
- WebClient.cs
- ソース:
- WebClient.cs
- ソース:
- WebClient.cs
指定した URI で識別されるリソースに指定した名前/値コレクションのデータをアップロードします。 このメソッドは、呼び出し元のスレッドをブロックしません。
public:
void UploadValuesAsync(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);
public void UploadValuesAsync (Uri address, System.Collections.Specialized.NameValueCollection data);
member this.UploadValuesAsync : Uri * System.Collections.Specialized.NameValueCollection -> unit
Public Sub UploadValuesAsync (address As Uri, data As NameValueCollection)
パラメーター
- address
- Uri
コレクションを受信するリソースの URI。 この URI は、既定のメソッドを使用して送信される要求を受け入れることができるリソースを識別するものであることが必要です。
- data
- NameValueCollection
リソースに送信する NameValueCollection。
例外
注釈
このメソッドは、リソースに文字列を送信します。 文字列は、スレッド プールから自動的に割り当てられるスレッド リソースを使用して非同期的に送信されます。 このメソッドは、文字列をアップロードする前に、 プロパティで Byte 指定されたエンコーディングを使用して配列に Encoding 変換します。 文字列のアップロードが完了したときに通知を受け取るために、イベント ハンドラーをイベントに UploadStringCompleted 追加できます。
このメソッドは、文字列の送信中に呼び出し元のスレッドをブロックしません。 サーバーの応答を待機している間に文字列とブロックを送信するには、いずれかのメソッドを UploadString 使用します。
.NET Framework と .NET Core 1.0 では、 メソッドを呼び出すことで、完了していない非同期操作を CancelAsync 取り消すことができます。
プロパティが BaseAddress 空の文字列 ("") address
ではなく、絶対 URI を含まない場合は、 address
と組み合わせて BaseAddress 、要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが空の QueryString 文字列でない場合は、 に address
追加されます。
このメソッドは、STOR コマンドを使用して FTP リソースをアップロードします。 HTTP リソースの場合は、POST メソッドが使用されます。
Note
このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「 .NET Framework でのネットワーク トレース」を参照してください。
このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって UploadValues(Uri, NameValueCollection)スローされる例外に関するページを参照してください。
適用対象
UploadValuesAsync(Uri, String, NameValueCollection)
- ソース:
- WebClient.cs
- ソース:
- WebClient.cs
- ソース:
- WebClient.cs
指定したメソッドを使用して、指定した URI で識別されるリソースに、指定した名前/値コレクションのデータをアップロードします。 このメソッドは、呼び出し元のスレッドをブロックしません。
public:
void UploadValuesAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);
public void UploadValuesAsync (Uri address, string? method, System.Collections.Specialized.NameValueCollection data);
public void UploadValuesAsync (Uri address, string method, System.Collections.Specialized.NameValueCollection data);
member this.UploadValuesAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> unit
Public Sub UploadValuesAsync (address As Uri, method As String, data As NameValueCollection)
パラメーター
- address
- Uri
コレクションを受信するリソースの URI。 この URI は、method
パラメーターに指定されたメソッドを使用して送信される要求を受け入れることができるリソースを識別するものであることが必要です。
- method
- String
リソースに文字列を送信するために使用するメソッド。 null の場合、http の既定値は POST、ftp の既定値は STOR です。
- data
- NameValueCollection
リソースに送信する NameValueCollection。
例外
BaseAddress および address
を組み合わせて形成された URI が無効です。
- または -
リソースをホストしているサーバーから応答がありませんでした。
- または -
method
を使用してコンテンツを送信することはできません。
注釈
このメソッドは、 に含まれる NameValueCollection データをリソースに address
送信します。 フォーム データを URI に送信して処理するには、このメソッドを使用します。 データは、フォーム urlencoded メディアの種類を使用して送信されます。Content-Type ヘッダー値は"application/x-www-form-urlencoded" に設定する必要があります。 ヘッダーは、既定で正しく設定されています。 UploadValuesAsyncコレクションに別の Content-Type ヘッダー値を設定してこのメソッドを呼び出すと、メソッドは をHeadersスローWebExceptionします。
メソッドが method
サーバーによって認識されない場合、基になるプロトコル クラスによって何が発生するかが決まります。 通常、 WebException は、エラーを示すために プロパティが Status 設定された 状態でスローされます。
NameValueCollectionは、スレッド プールから自動的に割り当てられるスレッド リソースを使用して非同期的に送信されます。 アップロード操作が完了したときに通知を受信するには、イベント ハンドラーを イベントに UploadValuesCompleted 追加します。
このメソッドは、文字列の送信中に呼び出し元のスレッドをブロックしません。 サーバーの応答を待機している間に文字列とブロックを送信するには、いずれかのメソッドを UploadValues 使用します。
.NET Framework と .NET Core 1.0 では、 メソッドを呼び出すことで、完了していない非同期操作を CancelAsync 取り消すことができます。
プロパティが BaseAddress 空の文字列 ("") address
ではなく、絶対 URI を含まない場合は、 address
と組み合わせて BaseAddress 、要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが QueryString 空でない場合は、 に address
追加されます。
Note
このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「 .NET Framework でのネットワーク トレース」を参照してください。
このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって UploadValues(Uri, String, NameValueCollection)スローされる例外に関するページを参照してください。
適用対象
UploadValuesAsync(Uri, String, NameValueCollection, Object)
- ソース:
- WebClient.cs
- ソース:
- WebClient.cs
- ソース:
- WebClient.cs
指定したメソッドを使用して、指定した URI で識別されるリソースに、指定した名前/値コレクションのデータをアップロードします。 このメソッドは、呼び出し元のスレッドをブロックしません。また、呼び出し元は、操作の完了時に呼び出されるメソッドにオブジェクトを渡すことができます。
public:
void UploadValuesAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data, System::Object ^ userToken);
public void UploadValuesAsync (Uri address, string? method, System.Collections.Specialized.NameValueCollection data, object? userToken);
public void UploadValuesAsync (Uri address, string method, System.Collections.Specialized.NameValueCollection data, object userToken);
member this.UploadValuesAsync : Uri * string * System.Collections.Specialized.NameValueCollection * obj -> unit
Public Sub UploadValuesAsync (address As Uri, method As String, data As NameValueCollection, userToken As Object)
パラメーター
- address
- Uri
コレクションを受信するリソースの URI。 この URI は、method
パラメーターに指定されたメソッドを使用して送信される要求を受け入れることができるリソースを識別するものであることが必要です。
- method
- String
リソースに文字列を送信するために使用する HTTP メソッド。 null の場合、http の既定値は POST、ftp の既定値は STOR です。
- data
- NameValueCollection
リソースに送信する NameValueCollection。
- userToken
- Object
非同期操作の完了時に呼び出されるメソッドに渡されるユーザー定義のオブジェクト。
例外
BaseAddress および address
を組み合わせて形成された URI が無効です。
- または -
リソースをホストしているサーバーから応答がありませんでした。
- または -
method
を使用してコンテンツを送信することはできません。
注釈
このメソッドは、 に含まれるデータを NameValueCollection リソースに address
送信します。 フォーム データを URI に送信して処理するには、このメソッドを使用します。 データは、フォーム urlencoded メディアの種類を使用して送信されます。Content-Type ヘッダー値は、"application/x-www-form-urlencoded" に設定する必要があります。 ヘッダーは既定で正しく設定されています。 UploadValuesAsyncコレクションに設定された別の Content-Type ヘッダー値を使用してこのメソッドを呼び出すと、メソッドは をHeadersスローWebExceptionします。
メソッドが method
サーバーによって認識されない場合、基になるプロトコル クラスによって何が発生するかが決まります。 通常、 WebException は、エラーを示すために プロパティが Status 設定された状態でスローされます。
NameValueCollectionは、スレッド プールから自動的に割り当てられるスレッド リソースを使用して非同期的に送信されます。 アップロード操作が完了したときに通知を受信するには、イベントにイベント ハンドラーを UploadValuesCompleted 追加します。
このメソッドは、文字列の送信中に呼び出し元のスレッドをブロックしません。 サーバーの応答を待機している間に文字列とブロックを送信するには、いずれかのメソッドを UploadValues 使用します。
.NET Framework と .NET Core 1.0 では、 メソッドを呼び出すことで、完了していない非同期操作を CancelAsync 取り消すことができます。
プロパティが空の BaseAddress 文字列 ("") address
ではなく、絶対 URI を含まない場合は、 address
と組み合わせて BaseAddress 要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが QueryString 空でない場合は、 に address
追加されます。
Note
このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「 .NET Framework でのネットワーク トレース」を参照してください。
適用対象
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示