WebClient.UploadString メソッド

リファレンス

定義

名前空間:: System.Net

アセンブリ:: System.Net.WebClient.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

オーバーロード

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

UploadString(String, String)

ソース:: WebClient.cs

ソース:: WebClient.cs

ソース:: 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

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。代わりに HttpClient を使用してください。

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

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

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

手記

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

適用対象

UploadString(Uri, String)

ソース:: WebClient.cs

ソース:: WebClient.cs

ソース:: 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

data: String

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

戻り値

String

サーバーによって送信された応答を含む String。

例外

ArgumentNullException

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

-又は-

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

WebException

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

-又は-

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

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。代わりに HttpClient を使用してください。

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

手記

適用対象

UploadString(String, String, String)

ソース:: WebClient.cs

ソース:: WebClient.cs

ソース:: WebClient.cs

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

public:
 System::String ^ UploadString(System::String ^ address, System::String ^ method, System::String ^ data);

public string UploadString (string address, string? method, 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

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。代わりに HttpClient を使用してください。

手記

適用対象

UploadString(Uri, String, String)

ソース:: WebClient.cs

ソース:: WebClient.cs

ソース:: WebClient.cs

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

public:
 System::String ^ UploadString(Uri ^ address, System::String ^ method, System::String ^ data);

public string UploadString (Uri address, string? method, 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 を使用してコンテンツを送信することはできません。

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。代わりに HttpClient を使用してください。

手記

適用対象

次の方法で共有

WebClient.UploadString メソッド

定義

オーバーロード

UploadString(String, String)

パラメーター

戻り値

例外

例

注釈

適用対象

UploadString(Uri, String)

パラメーター

戻り値

例外

注釈

適用対象

UploadString(String, String, String)

パラメーター

戻り値

例外

例

注釈

適用対象

UploadString(Uri, String, String)

パラメーター

戻り値

例外

注釈

適用対象

その他のリソース