WebClient.UploadStringAsync メソッド

定義

指定したリソースに指定した文字列をアップロードします。Uploads the specified string to the specified resource. これらのメソッドは、呼び出し元のスレッドをブロックしません。These methods do not block the calling thread.

オーバーロード

UploadStringAsync(Uri, String)

指定したリソースに指定した文字列をアップロードします。Uploads the specified string to the specified resource. このメソッドは、呼び出し元のスレッドをブロックしません。This method does not block the calling thread.

UploadStringAsync(Uri, String, String)

指定したリソースに指定した文字列をアップロードします。Uploads the specified string to the specified resource. このメソッドは、呼び出し元のスレッドをブロックしません。This method does not block the calling thread.

UploadStringAsync(Uri, String, String, Object)

指定したリソースに指定した文字列をアップロードします。Uploads the specified string to the specified resource. このメソッドは、呼び出し元のスレッドをブロックしません。This method does not block the calling thread.

UploadStringAsync(Uri, String)

指定したリソースに指定した文字列をアップロードします。Uploads the specified string to the specified resource. このメソッドは、呼び出し元のスレッドをブロックしません。This method does not block the calling thread.

public:
 void UploadStringAsync(Uri ^ address, System::String ^ data);
public void UploadStringAsync (Uri address, string data);
member this.UploadStringAsync : Uri * string -> unit
Public Sub UploadStringAsync (address As Uri, data As String)

パラメーター

address
Uri

文字列を受信するリソースの URI。The URI of the resource to receive the string. HTTP リソースの場合、この URI は POST メソッドを使用して送信される要求を受け入れることができるリソース (スクリプトや ASP ページなど) を識別するものであることが必要です。For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

data
String

アップロードする文字列。The string to be uploaded.

例外

address パラメーターが null です。The address parameter is null.

または-or-

data パラメーターが null です。The data parameter is null.

BaseAddress および address を組み合わせて形成された URI が無効です。The URI formed by combining BaseAddress and address is invalid.

- または --or-

リソースをホストしているサーバーから応答がありませんでした。There was no response from the server hosting the resource.

注釈

このメソッドは、リソースに文字列を送信します。This method sends a string to a resource. 文字列は、スレッドプールから自動的に割り当てられたスレッドリソースを使用して非同期的に送信されます。The string is sent asynchronously using thread resources that are automatically allocated from the thread pool. このメソッドは、文字列をアップロードする前に、 Byte プロパティで指定されたエンコーディングを使用して、配列に変換し Encoding ます。Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. 文字列のアップロードが完了したときに通知を受け取るには、イベントにイベントハンドラーを追加し UploadStringCompleted ます。To receive notification when the string upload completes, you can add an event handler to the UploadStringCompleted event.

このメソッドは、文字列の送信中に、呼び出し元のスレッドをブロックしません。This method does not block the calling thread while the string is being sent. サーバーの応答を待機している間に文字列とブロックを送信するには、メソッドのいずれかを使用し UploadString ます。To send a string and block while waiting for the server's response, use one of the UploadString methods.

.NET Framework と .NET Core 1.0 では、メソッドを呼び出して、完了していない非同期操作を取り消すことができ CancelAsync ます。In .NET Framework and .NET Core 1.0, you can cancel asynchronous operations that have not completed by calling the CancelAsync method.

BaseAddressプロパティが空の文字列 ("") ではなく、 address 絶対 uri も含まれていない場合、は、 address 要求された BaseAddress データの絶対 uri を形成するためにと組み合わせた相対 uri である必要があります。If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. QueryStringプロパティが空の文字列でない場合は、に追加され address ます。If the QueryString property is not an empty string, it is appended to address.

このメソッドでは、STOR コマンドを使用して FTP リソースをアップロードします。This method uses the STOR command to upload an FTP resource. HTTP リソースの場合は、POST メソッドが使用されます。For an HTTP resource, the POST method is used.

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。This member outputs trace information when you enable network tracing in your application. 詳細については、「 .NET Framework のネットワークトレース」を参照してください。For more information, see Network Tracing in .NET Framework.

適用対象

UploadStringAsync(Uri, String, String)

指定したリソースに指定した文字列をアップロードします。Uploads the specified string to the specified resource. このメソッドは、呼び出し元のスレッドをブロックしません。This method does not block the calling thread.

public:
 void UploadStringAsync(Uri ^ address, System::String ^ method, System::String ^ data);
public void UploadStringAsync (Uri address, string? method, string data);
public void UploadStringAsync (Uri address, string method, string data);
member this.UploadStringAsync : Uri * string * string -> unit
Public Sub UploadStringAsync (address As Uri, method As String, data As String)

パラメーター

address
Uri

文字列を受信するリソースの URI。The URI of the resource to receive the string. HTTP リソースの場合、この URI は POST メソッドを使用して送信される要求を受け入れることができるリソース (スクリプトや ASP ページなど) を識別するものであることが必要です。For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

method
String

リソースにファイルを送信するために使用する HTTP メソッド。The HTTP method used to send the file to the resource. null の場合、http の既定値は POST、ftp の既定値は STOR です。If null, the default is POST for http and STOR for ftp.

data
String

アップロードする文字列。The string to be uploaded.

例外

address パラメーターが null です。The address parameter is null.

または-or-

data パラメーターが null です。The data parameter is null.

BaseAddress および address を組み合わせて形成された URI が無効です。The URI formed by combining BaseAddress and address is invalid.

- または --or-

method を使用してコンテンツを送信することはできません。method cannot be used to send content.

- または --or-

リソースをホストしているサーバーから応答がありませんでした。There was no response from the server hosting the resource.

注釈

このメソッドは、リソースに文字列を送信します。This method sends a string to a resource. 文字列は、スレッドプールから自動的に割り当てられたスレッドリソースを使用して非同期的に送信されます。The string is sent asynchronously using thread resources that are automatically allocated from the thread pool. このメソッドは、文字列をアップロードする前に、 Byte プロパティで指定されたエンコーディングを使用して、配列に変換し Encoding ます。Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. 文字列のアップロードが完了したときに通知を受け取るには、イベントにイベントハンドラーを追加し UploadStringCompleted ます。To receive notification when the string upload completes, you can add an event handler to the UploadStringCompleted event.

このメソッドは、文字列の送信中に、呼び出し元のスレッドをブロックしません。This method does not block the calling thread while the string is being sent. サーバーの応答を待機している間に文字列とブロックを送信するには、メソッドのいずれかを使用し UploadString ます。To send a string and block while waiting for the server's response, use one of the UploadString methods.

.NET Framework と .NET Core 1.0 では、メソッドを呼び出して、完了していない非同期操作を取り消すことができ CancelAsync ます。In .NET Framework and .NET Core 1.0, you can cancel asynchronous operations that have not completed by calling the CancelAsync method.

BaseAddressプロパティが空の文字列 ("") ではなく、 address 絶対 uri も含まれていない場合、は、 address 要求された BaseAddress データの絶対 uri を形成するためにと組み合わせた相対 uri である必要があります。If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. QueryStringプロパティが空の文字列でない場合は、に追加され address ます。If the QueryString property is not an empty string, it is appended to address.

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。This member outputs trace information when you enable network tracing in your application. 詳細については、「 .NET Framework のネットワークトレース」を参照してください。For more information, see Network Tracing in .NET Framework.

適用対象

UploadStringAsync(Uri, String, String, Object)

指定したリソースに指定した文字列をアップロードします。Uploads the specified string to the specified resource. このメソッドは、呼び出し元のスレッドをブロックしません。This method does not block the calling thread.

public:
 void UploadStringAsync(Uri ^ address, System::String ^ method, System::String ^ data, System::Object ^ userToken);
public void UploadStringAsync (Uri address, string? method, string data, object? userToken);
public void UploadStringAsync (Uri address, string method, string data, object userToken);
member this.UploadStringAsync : Uri * string * string * obj -> unit
Public Sub UploadStringAsync (address As Uri, method As String, data As String, userToken As Object)

パラメーター

address
Uri

文字列を受信するリソースの URI。The URI of the resource to receive the string. HTTP リソースの場合、この URI は POST メソッドを使用して送信される要求を受け入れることができるリソース (スクリプトや ASP ページなど) を識別するものであることが必要です。For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

method
String

リソースにファイルを送信するために使用する HTTP メソッド。The HTTP method used to send the file to the resource. null の場合、http の既定値は POST、ftp の既定値は STOR です。If null, the default is POST for http and STOR for ftp.

data
String

アップロードする文字列。The string to be uploaded.

userToken
Object

非同期操作の完了時に呼び出されるメソッドに渡されるユーザー定義のオブジェクト。A user-defined object that is passed to the method invoked when the asynchronous operation completes.

例外

address パラメーターが null です。The address parameter is null.

または-or-

data パラメーターが null です。The data parameter is null.

BaseAddress および address を組み合わせて形成された URI が無効です。The URI formed by combining BaseAddress and address is invalid.

- または --or-

method を使用してコンテンツを送信することはできません。method cannot be used to send content.

- または --or-

リソースをホストしているサーバーから応答がありませんでした。There was no response from the server hosting the resource.

注釈

このメソッドは、リソースに文字列を送信します。This method sends a string to a resource. 文字列は、スレッドプールから自動的に割り当てられたスレッドリソースを使用して非同期的に送信されます。The string is sent asynchronously using thread resources that are automatically allocated from the thread pool. このメソッドは、文字列をアップロードする前に、 Byte プロパティで指定されたエンコーディングを使用して、配列に変換し Encoding ます。Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. 文字列のアップロードが完了したときに通知を受け取るには、イベントにイベントハンドラーを追加し UploadStringCompleted ます。To receive notification when the string upload completes, you can add an event handler to the UploadStringCompleted event.

このメソッドは、文字列の送信中に、呼び出し元のスレッドをブロックしません。This method does not block the calling thread while the string is being sent. サーバーの応答を待機している間に文字列とブロックを送信するには、メソッドのいずれかを使用し UploadString ます。To send a string and block while waiting for the server's response, use one of the UploadString methods.

.NET Framework と .NET Core 1.0 では、メソッドを呼び出して、完了していない非同期操作を取り消すことができ CancelAsync ます。In .NET Framework and .NET Core 1.0, you can cancel asynchronous operations that have not completed by calling the CancelAsync method.

BaseAddressプロパティが空の文字列 ("") ではなく、 address 絶対 uri も含まれていない場合、は、 address 要求された BaseAddress データの絶対 uri を形成するためにと組み合わせた相対 uri である必要があります。If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. QueryStringプロパティが空の文字列でない場合は、に追加され address ます。If the QueryString property is not an empty string, it is appended to address.

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。This member outputs trace information when you enable network tracing in your application. 詳細については、「 .NET Framework のネットワークトレース」を参照してください。For more information, see Network Tracing in .NET Framework.

適用対象