WebClient.Encoding Propriedade

Definição

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Origem:

WebClient.cs

Obtém ou define o Encoding usado para carregar e baixar cadeias de caracteres.

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

public System.Text.Encoding Encoding { get; set; }

member this.Encoding : System.Text.Encoding with get, set

Public Property Encoding As Encoding

Valor da propriedade

Encoding

Um Encoding usado para codificar cadeias de caracteres. O valor padrão dessa propriedade é a codificação retornada por Default.

Exemplos

O exemplo de código a seguir demonstra como definir o valor dessa propriedade.

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

Comentários

Cuidado

WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

Os métodos UploadString e UploadStringAsync usam essa propriedade para converter a cadeia de caracteres especificada em uma matriz de Byte antes de carregar a cadeia de caracteres. Para obter informações adicionais, consulte o método GetBytes.

Quando uma cadeia de caracteres é baixada usando os métodos DownloadString ou DownloadStringAsync, WebClient usa a Encoding retornada por isso para converter a matriz de Byte baixada em uma cadeia de caracteres. Para obter informações adicionais, consulte o método GetString.