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 は POST メソッドを使用して送信される要求を受け入れることができるリソース (スクリプトや ASP ページなど) を識別するものであることが必要です。

method

String

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

data

String

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

戻り値

Task<String>

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

例外

ArgumentNullException

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

または

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

WebException

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

- または -

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

- または -

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

注釈

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

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

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

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

Note

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.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 は POST メソッドを使用して送信される要求を受け入れることができるリソース (スクリプトや ASP ページなど) を識別するものであることが必要です。

method

String

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

data

String

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

戻り値

Task<String>

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

例外

ArgumentNullException

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

または

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

WebException

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

- または -

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

- または -

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

注釈

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

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

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

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

Note

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.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 は POST メソッドを使用して送信される要求を受け入れることができるリソース (スクリプトや ASP ページなど) を識別するものであることが必要です。

data

String

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

戻り値

Task<String>

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

例外

ArgumentNullException

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

または

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

WebException

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

- または -

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

注釈

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

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

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

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

Note

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.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 は POST メソッドを使用して送信される要求を受け入れることができるリソース (スクリプトや ASP ページなど) を識別するものであることが必要です。

data

String

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

戻り値

Task<String>

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

例外

ArgumentNullException

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

または

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

WebException

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

- または -

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

注釈

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

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

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

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

Note

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