WebClient.UploadString WebClient.UploadString WebClient.UploadString WebClient.UploadString Method

定義

指定したリソースに指定した文字列をアップロードします。Uploads the specified string to the specified resource.

オーバーロード

UploadString(String, String) UploadString(String, String) UploadString(String, String) UploadString(String, String)

POST メソッドを使用して、指定したリソースに指定した文字列をアップロードします。Uploads the specified string to the specified resource, using the POST method.

UploadString(Uri, String) UploadString(Uri, String) UploadString(Uri, String) UploadString(Uri, String)

POST メソッドを使用して、指定したリソースに指定した文字列をアップロードします。Uploads the specified string to the specified resource, using the POST method.

UploadString(String, String, String) UploadString(String, String, String) UploadString(String, String, String) UploadString(String, String, String)

指定したメソッドを使用して、指定したリソースに指定した文字列をアップロードします。Uploads the specified string to the specified resource, using the specified method.

UploadString(Uri, String, String) UploadString(Uri, String, String) UploadString(Uri, String, String) UploadString(Uri, String, String)

指定したメソッドを使用して、指定したリソースに指定した文字列をアップロードします。Uploads the specified string to the specified resource, using the specified method.

UploadString(String, String) UploadString(String, String) UploadString(String, String) UploadString(String, String)

POST メソッドを使用して、指定したリソースに指定した文字列をアップロードします。Uploads the specified string to the specified resource, using the POST method.

public:
 System::String ^ UploadString(System::String ^ address, System::String ^ data);
public string UploadString (string address, string data);
member this.UploadString : string * string -> string
Public Function UploadString (address As String, data As String) As String

パラメーター

address
String String String String

文字列を受信するリソースの 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 String String String

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

戻り値

サーバーが送信した応答を格納している StringA String containing the response sent by the server.

例外

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.

次のコード例では、このメソッドの呼び出しを示しています。The following code example demonstrates calling this method.

void UploadString( String^ address )
{
   String^ data = "Time = 12:00am temperature = 50";
   WebClient^ client = gcnew WebClient;
   
   // Optionally specify an encoding for uploading and downloading strings.
   client->Encoding = System::Text::Encoding::UTF8;
   
   // Upload the data.
   String^ reply = client->UploadString( address, data );
   
   // Disply the server's response.
   Console::WriteLine( reply );
}


public static void UploadString (string address)
{
    string data = "Time = 12:00am temperature = 50";
    WebClient client = new WebClient ();
    // Optionally specify an encoding for uploading and downloading strings.
    client.Encoding = System.Text.Encoding.UTF8;
    // Upload the data.
    string reply = client.UploadString (address, data);
    // Disply the server's response.
    Console.WriteLine (reply);
}

Public Shared Sub UploadString(ByVal address As String)

	Dim data As String = "Time = 12:00am temperature = 50"
	Dim client As WebClient = New WebClient()
	'  Optionally specify an encoding for uploading and downloading strings.
	client.Encoding = System.Text.Encoding.UTF8
	'  Upload the data.
	Dim reply As String = client.UploadString(address, data)
	'  Disply the server's response.
	Console.WriteLine(reply)
End Sub

注釈

このメソッドでは、文字列をアップロードする前に変換して、Byte配列に指定されたエンコーディングを使用して、Encodingプロパティ。Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. このメソッドは、文字列の送信中にブロックします。This method blocks while the string is transmitted. 文字列を送信し、サーバーの応答の待機中に実行を継続してのいずれかの操作を使用して、UploadStringAsyncメソッド。To send a string and continue executing while waiting for the server's response, use one of the UploadStringAsync methods.

場合、BaseAddressプロパティが空の文字列 ("")、およびaddress、絶対 URI が含まれていないaddressと組み合わせる相対 URI でなければなりませんBaseAddress要求されたデータの絶対 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.

このメソッドは、FTP リソースをアップロードするのに STOR コマンドを使用します。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 the .NET Framework.

UploadString(Uri, String) UploadString(Uri, String) UploadString(Uri, String) UploadString(Uri, String)

POST メソッドを使用して、指定したリソースに指定した文字列をアップロードします。Uploads the specified string to the specified resource, using the POST method.

public:
 System::String ^ UploadString(Uri ^ address, System::String ^ data);
public string UploadString (Uri address, string data);
member this.UploadString : Uri * string -> string
Public Function UploadString (address As Uri, data As String) As String

パラメーター

address
Uri Uri Uri 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 String String String

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

戻り値

サーバーが送信した応答を格納している StringA String containing the response sent by the server.

例外

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.

注釈

このメソッドでは、文字列をアップロードする前に変換して、Byte配列に指定されたエンコーディングを使用して、Encodingプロパティ。Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. このメソッドは、文字列の送信中にブロックします。This method blocks while the string is transmitted. 文字列を送信し、サーバーの応答の待機中に実行を継続してのいずれかの操作を使用して、UploadStringAsyncメソッド。To send a string and continue executing while waiting for the server's response, use one of the UploadStringAsync methods.

場合、BaseAddressプロパティが空の文字列 ("")、およびaddress、絶対 URI が含まれていないaddressと組み合わせる相対 URI でなければなりませんBaseAddress要求されたデータの絶対 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.

このメソッドは、FTP リソースをアップロードするのに STOR コマンドを使用します。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 the .NET Framework.

UploadString(String, String, String) UploadString(String, String, String) UploadString(String, String, String) UploadString(String, String, String)

指定したメソッドを使用して、指定したリソースに指定した文字列をアップロードします。Uploads the specified string to the specified resource, using the specified method.

public:
 System::String ^ UploadString(System::String ^ address, System::String ^ method, System::String ^ data);
public string UploadString (string address, string method, string data);
member this.UploadString : string * string * string -> string
Public Function UploadString (address As String, method As String, data As String) As String

パラメーター

address
String String String String

文字列を受信するリソースの URI。The URI of the resource to receive the string. この URI は、method パラメーターに指定されたメソッドを使用して送信される要求を受け入れることができるリソースを識別するものであることが必要です。This URI must identify a resource that can accept a request sent with the method method.

method
String String String String

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

data
String String String String

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

戻り値

サーバーが送信した応答を格納している StringA String containing the response sent by the server.

例外

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.

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

次のコード例では、このメソッドの呼び出しを示しています。The following code example demonstrates calling this method.

void PostString( String^ address )
{
   String^ data = "Time = 12:00am temperature = 50";
   String^ method = "POST";
   WebClient^ client = gcnew WebClient;
   String^ reply = client->UploadString( address, method, data );
   Console::WriteLine( reply );
}


public static void PostString (string address)
{
    string data = "Time = 12:00am temperature = 50";
    string method = "POST";
    WebClient client = new WebClient ();
    string reply = client.UploadString (address, method, data);

    Console.WriteLine (reply);
}

Public Shared Sub PostString(ByVal address As String)

	Dim data As String = "Time = 12:00am temperature = 50"
	Dim method As String = "POST"
	Dim client As WebClient = New WebClient()
	Dim reply As String = client.UploadString(address, method, data)

	Console.WriteLine(reply)
End Sub

注釈

このメソッドでは、文字列をアップロードする前に変換して、Byte配列に指定されたエンコーディングを使用して、Encodingプロパティ。Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. このメソッドは、文字列の送信中にブロックします。This method blocks while the string is transmitted. 文字列を送信し、サーバーの応答の待機中に実行を継続してのいずれかの操作を使用して、UploadStringAsyncメソッド。To send a string and continue executing while waiting for the server's response, use one of the UploadStringAsync methods.

場合、BaseAddressプロパティは空の文字列ではありません ("") とaddress、絶対 URI が含まれていないaddressと組み合わせる相対 URI でなければなりませんBaseAddressを要求されたデータの絶対 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 the .NET Framework.

UploadString(Uri, String, String) UploadString(Uri, String, String) UploadString(Uri, String, String) UploadString(Uri, String, String)

指定したメソッドを使用して、指定したリソースに指定した文字列をアップロードします。Uploads the specified string to the specified resource, using the specified method.

public:
 System::String ^ UploadString(Uri ^ address, System::String ^ method, System::String ^ data);
public string UploadString (Uri address, string method, string data);
member this.UploadString : Uri * string * string -> string
Public Function UploadString (address As Uri, method As String, data As String) As String

パラメーター

address
Uri Uri Uri Uri

文字列を受信するリソースの URI。The URI of the resource to receive the string. この URI は、method パラメーターに指定されたメソッドを使用して送信される要求を受け入れることができるリソースを識別するものであることが必要です。This URI must identify a resource that can accept a request sent with the method method.

method
String String String String

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

data
String String String String

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

戻り値

サーバーが送信した応答を格納している StringA String containing the response sent by the server.

例外

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.

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

注釈

このメソッドでは、文字列をアップロードする前に変換して、Byte配列に指定されたエンコーディングを使用して、Encodingプロパティ。Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. このメソッドは、文字列の送信中にブロックします。This method blocks while the string is transmitted. 文字列を送信し、サーバーの応答の待機中に実行を継続してのいずれかの操作を使用して、UploadStringAsyncメソッド。To send a string and continue executing while waiting for the server's response, use one of the UploadStringAsync methods.

場合、BaseAddressプロパティは空の文字列ではありません ("") とaddress、絶対 URI が含まれていないaddressと組み合わせる相対 URI でなければなりませんBaseAddressを要求されたデータの絶対 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 the .NET Framework.

適用対象