WebClient.UploadStringTaskAsync メソッド

定義

名前空間:

System.Net

アセンブリ:

System.Net.WebClient.dll

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

オーバーロード

UploadStringTaskAsync(Uri, String, String)	タスク オブジェクトを使用して、指定した文字列を非同期操作として指定されたリソースにアップロードします。
UploadStringTaskAsync(String, String, String)	タスク オブジェクトを使用して、指定した文字列を非同期操作として指定されたリソースにアップロードします。
UploadStringTaskAsync(String, String)	タスク オブジェクトを使用して、指定した文字列を非同期操作として指定されたリソースにアップロードします。
UploadStringTaskAsync(Uri, String)	タスク オブジェクトを使用して、指定した文字列を非同期操作として指定されたリソースにアップロードします。

UploadStringTaskAsync(Uri, String, String)

ソース:

WebClient.cs

タスク オブジェクトを使用して、指定した文字列を非同期操作として指定されたリソースにアップロードします。

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(Uri ^ address, System::String ^ method, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string? method, string data);

member this.UploadStringTaskAsync : Uri * string * string -> System.Threading.Tasks.Task<string>

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

パラメーター

address

Uri

文字列を受信するリソースの URI。 HTTP リソースの場合、この URI は、スクリプトや ASP ページなど、POST メソッドで送信された要求を受け入れることができるリソースを識別する必要があります。

method

String

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

data

String

アップロードする文字列。

戻り値

Task<String>

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

例外

ArgumentNullException

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

-又は-

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

WebException

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

-又は-

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

-又は-

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

注釈

注意

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

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

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

このメソッドは、文字列をアップロードする前に、Encoding プロパティで指定されたエンコードを使用して、文字列を Byte 配列に変換します。 このメソッドは、文字列の送信中にブロックします。

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

手記

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

UploadStringTaskAsync(String, String, String)

ソース:

WebClient.cs

タスク オブジェクトを使用して、指定した文字列を非同期操作として指定されたリソースにアップロードします。

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(System::String ^ address, System::String ^ method, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string? method, string data);

member this.UploadStringTaskAsync : string * string * string -> System.Threading.Tasks.Task<string>

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

パラメーター

address

String

文字列を受信するリソースの URI。 HTTP リソースの場合、この URI は、スクリプトや ASP ページなど、POST メソッドで送信された要求を受け入れることができるリソースを識別する必要があります。

method

String

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

data

String

アップロードする文字列。

戻り値

Task<String>

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

例外

ArgumentNullException

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

-又は-

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

WebException

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

-又は-

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

-又は-

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

注釈

注意

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

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

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

このメソッドは、文字列をアップロードする前に、Encoding プロパティで指定されたエンコードを使用して、文字列を Byte 配列に変換します。 このメソッドは、文字列の送信中にブロックします。

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

手記

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

UploadStringTaskAsync(String, String)

ソース:

WebClient.cs

タスク オブジェクトを使用して、指定した文字列を非同期操作として指定されたリソースにアップロードします。

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(System::String ^ address, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string data);

member this.UploadStringTaskAsync : string * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As String, data As String) As Task(Of String)

パラメーター

address

String

文字列を受信するリソースの URI。 HTTP リソースの場合、この URI は、スクリプトや ASP ページなど、POST メソッドで送信された要求を受け入れることができるリソースを識別する必要があります。

data

String

アップロードする文字列。

戻り値

Task<String>

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

例外

ArgumentNullException

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

-又は-

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

WebException

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

-又は-

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

注釈

注意

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

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

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

このメソッドは、文字列をアップロードする前に、Encoding プロパティで指定されたエンコードを使用して、文字列を Byte 配列に変換します。 このメソッドは、文字列の送信中にブロックします。

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

手記

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

UploadStringTaskAsync(Uri, String)

ソース:

WebClient.cs

タスク オブジェクトを使用して、指定した文字列を非同期操作として指定されたリソースにアップロードします。

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(Uri ^ address, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string data);

member this.UploadStringTaskAsync : Uri * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As Uri, data As String) As Task(Of String)

パラメーター

address

Uri

文字列を受信するリソースの URI。 HTTP リソースの場合、この URI は、スクリプトや ASP ページなど、POST メソッドで送信された要求を受け入れることができるリソースを識別する必要があります。

data

String

アップロードする文字列。

戻り値

Task<String>

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

例外

ArgumentNullException

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

-又は-

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

WebException

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

-又は-

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

注釈

注意

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

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

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

このメソッドは、文字列をアップロードする前に、Encoding プロパティで指定されたエンコードを使用して、文字列を Byte 配列に変換します。 このメソッドは、文字列の送信中にブロックします。

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

手記

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