WebClient.Encoding Property

Note: This property is new in the .NET Framework version 2.0.

Gets and sets the Encoding used to upload and download strings.

Namespace: System.Net
Assembly: System (in system.dll)

public Encoding Encoding { get; set; }
/** @property */
public Encoding get_Encoding ()

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

public function get Encoding () : Encoding

public function set Encoding (value : Encoding)

Property Value

A Encoding that is used to encode strings. The default value of this property is the encoding returned by Default.

The UploadString and UploadStringAsync methods use this property to convert the specified string to a Byte array before uploading the string. For additional information, see the O:System.Text.Encoding.GetBytes method.

When a string is downloaded using the DownloadString or DownloadStringAsync methods, WebClient uses the Encoding returned by this to convert the downloaded Byte array into a string. For additional information, see the O:System.Text.Encoding.GetString method.

The following code example demonstrates setting the value of this property.

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

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0