WebClient.UploadDataTaskAsync メソッド

定義

名前空間:

System.Net

アセンブリ:

System.Net.WebClient.dll

Byte 配列を含むデータ バッファーを、タスク オブジェクトを使用した非同期操作として指定された URI にアップロードします。 これらのメソッドは、呼び出し元のスレッドをブロックしません。

オーバーロード

UploadDataTaskAsync(String, Byte[])	Byte 配列を含むデータ バッファーを、タスク オブジェクトを使用した非同期操作として指定された URI にアップロードします。
UploadDataTaskAsync(Uri, Byte[])	Byte 配列を含むデータ バッファーを、タスク オブジェクトを使用した非同期操作として指定された URI にアップロードします。
UploadDataTaskAsync(String, String, Byte[])	Byte 配列を含むデータ バッファーを、タスク オブジェクトを使用した非同期操作として指定された URI にアップロードします。
UploadDataTaskAsync(Uri, String, Byte[])	Byte 配列を含むデータ バッファーを、タスク オブジェクトを使用した非同期操作として指定された URI にアップロードします。

UploadDataTaskAsync(String, Byte[])

ソース:

WebClient.cs

Byte 配列を含むデータ バッファーを、タスク オブジェクトを使用した非同期操作として指定された URI にアップロードします。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(System::String ^ address, cli::array <System::Byte> ^ data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (string address, byte[] data);

member this.UploadDataTaskAsync : string * byte[] -> System.Threading.Tasks.Task<byte[]>

Public Function UploadDataTaskAsync (address As String, data As Byte()) As Task(Of Byte())

パラメーター

address

String

データを受信するリソースの URI。

data

Byte[]

リソースに送信するデータ バッファー。

戻り値

Task<Byte[]>

非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、データ バッファーのアップロード時にリソースから受信した応答の本文を含む Byte 配列を返します。

例外

ArgumentNullException

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

WebException

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

-又は-

ストリームを開くときにエラーが発生しました。

-又は-

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

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。 代わりに HttpClient を使用してください。

この操作はブロックされません。 返された Task<TResult> オブジェクトは、データ バッファーがリソースにアップロードされた後に完了します。

このメソッドは、データ バッファーをリソースに送信します。 データ バッファーは、スレッド プールから自動的に割り当てられるスレッド リソースを使用して非同期的に送信されます。 データはエンコードされません。

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

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

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

手記

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

UploadDataTaskAsync(Uri, Byte[])

ソース:

WebClient.cs

Byte 配列を含むデータ バッファーを、タスク オブジェクトを使用した非同期操作として指定された URI にアップロードします。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(Uri ^ address, cli::array <System::Byte> ^ data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (Uri address, byte[] data);

member this.UploadDataTaskAsync : Uri * byte[] -> System.Threading.Tasks.Task<byte[]>

Public Function UploadDataTaskAsync (address As Uri, data As Byte()) As Task(Of Byte())

パラメーター

address

Uri

データを受信するリソースの URI。

data

Byte[]

リソースに送信するデータ バッファー。

戻り値

Task<Byte[]>

非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、データ バッファーのアップロード時にリソースから受信した応答の本文を含む Byte 配列を返します。

例外

ArgumentNullException

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

WebException

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

-又は-

ストリームを開くときにエラーが発生しました。

-又は-

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

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。 代わりに HttpClient を使用してください。

この操作はブロックされません。 返された Task<TResult> オブジェクトは、データ バッファーがリソースにアップロードされた後に完了します。

このメソッドは、データ バッファーをリソースに送信します。 データ バッファーは、スレッド プールから自動的に割り当てられるスレッド リソースを使用して非同期的に送信されます。 データはエンコードされません。

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

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

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

手記

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

UploadDataTaskAsync(String, String, Byte[])

ソース:

WebClient.cs

Byte 配列を含むデータ バッファーを、タスク オブジェクトを使用した非同期操作として指定された URI にアップロードします。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(System::String ^ address, System::String ^ method, cli::array <System::Byte> ^ data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (string address, string? method, byte[] data);

member this.UploadDataTaskAsync : string * string * byte[] -> System.Threading.Tasks.Task<byte[]>

Public Function UploadDataTaskAsync (address As String, method As String, data As Byte()) As Task(Of Byte())

パラメーター

address

String

データを受信するリソースの URI。

method

String

リソースにデータを送信するために使用されるメソッド。 nullの場合、既定値は HTTP の場合は POST、FTP の場合は STOR です。

data

Byte[]

リソースに送信するデータ バッファー。

戻り値

Task<Byte[]>

非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、データ バッファーのアップロード時にリソースから受信した応答の本文を含む Byte 配列を返します。

例外

ArgumentNullException

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

WebException

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

-又は-

ストリームを開くときにエラーが発生しました。

-又は-

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

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。 代わりに HttpClient を使用してください。

この操作はブロックされません。 返された Task<TResult> オブジェクトは、データ バッファーがリソースにアップロードされた後に完了します。

このメソッドは、データ バッファーをリソースに送信します。 データ バッファーは、スレッド プールから自動的に割り当てられるスレッド リソースを使用して非同期的に送信されます。 データはエンコードされません。

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

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

手記

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

UploadDataTaskAsync(Uri, String, Byte[])

ソース:

WebClient.cs

Byte 配列を含むデータ バッファーを、タスク オブジェクトを使用した非同期操作として指定された URI にアップロードします。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (Uri address, string? method, byte[] data);

member this.UploadDataTaskAsync : Uri * string * byte[] -> System.Threading.Tasks.Task<byte[]>

Public Function UploadDataTaskAsync (address As Uri, method As String, data As Byte()) As Task(Of Byte())

パラメーター

address

Uri

データを受信するリソースの URI。

method

String

リソースにデータを送信するために使用されるメソッド。 nullの場合、既定値は HTTP の場合は POST、FTP の場合は STOR です。

data

Byte[]

リソースに送信するデータ バッファー。

戻り値

Task<Byte[]>

非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、データ バッファーのアップロード時にリソースから受信した応答の本文を含む Byte 配列を返します。

例外

ArgumentNullException

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

WebException

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

-又は-

ストリームを開くときにエラーが発生しました。

-又は-

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

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。 代わりに HttpClient を使用してください。

この操作はブロックされません。 返された Task<TResult> オブジェクトは、データ バッファーがリソースにアップロードされた後に完了します。

このメソッドは、データ バッファーをリソースに送信します。 データ バッファーは、スレッド プールから自動的に割り当てられるスレッド リソースを使用して非同期的に送信されます。 データはエンコードされません。

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

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

手記

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