This documentation is archived and is not being maintained.

WebClient.Encoding Property

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

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

Public Property Encoding As Encoding
Dim instance As WebClient 
Dim value As Encoding 

value = instance.Encoding

instance.Encoding = value

Property Value

Type: System.Text.Encoding
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 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 GetString method.

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

		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.
		End Sub
void UploadString (String* address)
    String* data = S"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 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

.NET Framework

Supported in: 3.5, 3.0, 2.0