WebClient.Encoding プロパティ

.NET Framework クラス ライブラリ リファレンス

WebClient.Encoding プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

文字列のアップロードとダウンロードに使用する Encoding を取得または設定します。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Property Encoding As
 Encoding

Visual Basic (使用法)

Dim instance As WebClient
Dim value As Encoding

value = instance.Encoding

instance.Encoding = value

C#

public Encoding Encoding { get; set;
 }

C++

public:
property Encoding^ Encoding {
    Encoding^ get ();
    void set (Encoding^ value);
}

J#

/** @property */
public Encoding get_Encoding ()

/** @property */
public void set_Encoding (Encoding value)

JScript

public function get Encoding
 () : Encoding

public function set Encoding
 (value : Encoding)

プロパティ値
文字列のエンコードに使用する Encoding。このプロパティの既定値は、Default によって返されるエンコーディングです。

解説

UploadString メソッドと UploadStringAsync メソッドは、指定した文字列をアップロードする前に、このプロパティを使用して文字列を Byte 配列に変換します。詳細については、O:System.Text.Encoding.GetBytes メソッドのトピックを参照してください。

DownloadString メソッドまたは DownloadStringAsync メソッドを使用して文字列をダウンロードしたときに、WebClient はこのプロパティによって返される Encoding を使用して、ダウンロードされた Byte 配列を文字列に変換します。詳細については、O:System.Text.Encoding.GetString メソッドのトピックを参照してください。

使用例

このプロパティの値を設定するコード例を次に示します。

Visual Basic

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

C#

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);
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
WebClient クラス
WebClient メンバ
System.Net 名前空間