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