WebClient.UploadStringTaskAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
タスク オブジェクトを使用した非同期操作として指定されたリソースに指定された文字列をアップロードします。 これらのメソッドは、呼び出し元のスレッドをブロックしません。
オーバーロード
UploadStringTaskAsync(Uri, String, String) |
タスク オブジェクトを使用した非同期操作として指定されたリソースに指定された文字列をアップロードします。 |
UploadStringTaskAsync(String, String, String) |
タスク オブジェクトを使用した非同期操作として指定されたリソースに指定された文字列をアップロードします。 |
UploadStringTaskAsync(String, String) |
タスク オブジェクトを使用した非同期操作として指定されたリソースに指定された文字列をアップロードします。 |
UploadStringTaskAsync(Uri, String) |
タスク オブジェクトを使用した非同期操作として指定されたリソースに指定された文字列をアップロードします。 |
UploadStringTaskAsync(Uri, String, String)
- ソース:
- WebClient.cs
- ソース:
- WebClient.cs
- ソース:
- 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);
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string method, string data);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string method, string data);
member this.UploadStringTaskAsync : Uri * string * string -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
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
アップロードする文字列。
戻り値
非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、サーバーから送信された応答を含む String を返します。
- 属性
例外
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
- ソース:
- WebClient.cs
- ソース:
- 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);
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string method, string data);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string method, string data);
member this.UploadStringTaskAsync : string * string * string -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
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
アップロードする文字列。
戻り値
非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、サーバーから送信された応答を含む String を返します。
- 属性
例外
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
- ソース:
- WebClient.cs
- ソース:
- 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);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string data);
member this.UploadStringTaskAsync : string * string -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
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
アップロードする文字列。
戻り値
非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、サーバーから送信された応答を含む String を返します。
- 属性
例外
注釈
この操作はブロックされません。 返された 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
- ソース:
- WebClient.cs
- ソース:
- 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);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string data);
member this.UploadStringTaskAsync : Uri * string -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
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
アップロードする文字列。
戻り値
非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、サーバーから送信された応答を含む String を返します。
- 属性
例外
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、文字列がリソースにアップロードされた後に完了します。 文字列は、スレッド プールから自動的に割り当てられるスレッド リソースを使用して非同期的に送信されます。
.NET Framework と .NET Core 1.0 では、 メソッドを呼び出すことで、完了していない非同期操作を CancelAsync 取り消すことができます。
このメソッドは、文字列をアップロードする前に、 プロパティで Byte 指定されたエンコーディングを使用して配列に Encoding 変換します。 このメソッドは、文字列の送信中にブロックします。
プロパティが BaseAddress 空の文字列 ("") address
ではなく、絶対 URI を含まない場合は、 address
と組み合わせて BaseAddress 、要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが空の QueryString 文字列でない場合は、 に address
追加されます。
Note
このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「 .NET Framework でのネットワーク トレース」を参照してください。
適用対象
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示