WebClient.UploadString メソッド

定義

名前空間:

System.Net

アセンブリ:

System.Net.WebClient.dll

指定したリソースに指定した文字列をアップロードします。

オーバーロード

UploadString(String, String)	POST メソッドを使用して、指定したリソースに指定した文字列をアップロードします。
UploadString(Uri, String)	POST メソッドを使用して、指定したリソースに指定した文字列をアップロードします。
UploadString(String, String, String)	指定したメソッドを使用して、指定したリソースに指定した文字列をアップロードします。
UploadString(Uri, String, String)	指定したメソッドを使用して、指定したリソースに指定した文字列をアップロードします。

UploadString(String, String)

ソース:

WebClient.cs

POST メソッドを使用して、指定したリソースに指定した文字列をアップロードします。

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

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

data

String

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

戻り値

String

サーバーが送信した応答を格納している String。

例外

ArgumentNullException

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

または

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

WebException

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

- または -

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

例

次のコード例では、このメソッドの呼び出しを示します。

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);
    // Display 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 変換します。 このメソッドは、文字列の送信中にブロックします。 サーバーの応答を待機しながら文字列を送信し、実行を続けるには、いずれかのメソッドを UploadStringAsync 使用します。

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

このメソッドでは、STOR コマンドを使用して FTP リソースをアップロードします。 HTTP リソースの場合は、POST メソッドが使用されます。

Note

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

UploadString(Uri, String)

ソース:

WebClient.cs

POST メソッドを使用して、指定したリソースに指定した文字列をアップロードします。

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

data

String

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

戻り値

String

サーバーが送信した応答を格納している String。

例外

ArgumentNullException

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

または

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

WebException

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

- または -

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

注釈

このメソッドは、文字列をアップロードする前に、 プロパティで Byte 指定されたエンコーディングを使用して配列に Encoding 変換します。 このメソッドは、文字列の送信中にブロックします。 サーバーの応答を待機しながら文字列を送信し、実行を続けるには、いずれかのメソッドを UploadStringAsync 使用します。

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

このメソッドでは、STOR コマンドを使用して FTP リソースをアップロードします。 HTTP リソースの場合は、POST メソッドが使用されます。

Note

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

UploadString(String, String, String)

ソース:

WebClient.cs

指定したメソッドを使用して、指定したリソースに指定した文字列をアップロードします。

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

文字列を受信するリソースの URI。 この URI は、method パラメーターに指定されたメソッドを使用して送信される要求を受け入れることができるリソースを識別するものであることが必要です。

method

String

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

data

String

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

戻り値

String

サーバーが送信した応答を格納している String。

例外

ArgumentNullException

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

または

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

WebException

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

- または -

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

- または -

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 変換します。 このメソッドは、文字列の送信中にブロックします。 サーバーの応答を待機しながら文字列を送信し、実行を続けるには、いずれかのメソッドを UploadStringAsync 使用します。

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

Note

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

UploadString(Uri, String, String)

ソース:

WebClient.cs

指定したメソッドを使用して、指定したリソースに指定した文字列をアップロードします。

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 は、method パラメーターに指定されたメソッドを使用して送信される要求を受け入れることができるリソースを識別するものであることが必要です。

method

String

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

data

String

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

戻り値

String

サーバーが送信した応答を格納している String。

例外

ArgumentNullException

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

または

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

WebException

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

- または -

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

- または -

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

注釈

このメソッドは、文字列をアップロードする前に、 プロパティで Byte 指定されたエンコーディングを使用して配列に Encoding 変換します。 このメソッドは、文字列の送信中にブロックします。 サーバーの応答を待機しながら文字列を送信し、実行を続けるには、いずれかのメソッドを UploadStringAsync 使用します。

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

Note

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