Encoding.Default Propriedade

Definição

Obtém a codificação padrão para esta implementação .NET.

public:
 static property System::Text::Encoding ^ Default { System::Text::Encoding ^ get(); };
public static System.Text.Encoding Default { get; }
static member Default : System.Text.Encoding
Public Shared ReadOnly Property Default As Encoding

Valor de Propriedade

A codificação padrão para esta implementação .NET.

Observações

O comportamento da propriedade Default varia entre diferentes implementações .NET:

  • In .NET Framework: Devolve a codificação que corresponde à página de código ativa do sistema. Esta é a mesma codificação devolvida por GetEncoding(Int32) quando chamada com um codepage argumento de 0.

  • No .NET Core e versões posteriores: Devolve sempre um objeto UTF8Encoding. Este comportamento foi alterado para incentivar o uso de codificações Unicode para melhor compatibilidade multiplataforma e integridade dos dados.

Para obter resultados mais consistentes em diferentes plataformas e implementações .NET, considere usar diretamente uma codificação Unicode específica, como UTF-8, em vez de depender da codificação padrão. Pode obter codificação UTF-8 chamando Encoding.UTF8 ou Encoding.GetEncoding(String) com "utf-8".

Warning

Computadores diferentes podem usar codificações diferentes como padrão, e a codificação padrão pode mudar em um único computador. Se usar a Encoding.Default codificação para codificar e decodificar dados transmitidos entre computadores ou recuperados em momentos diferentes no mesmo computador, pode traduzir esses dados incorretamente. Além disso, a codificação retornada pela propriedade usa fallback Default de melhor ajuste para mapear caracteres sem suporte para caracteres suportados pela página de código. Por esses motivos, o uso da codificação padrão não é recomendado. Para garantir que os bytes codificados sejam decodificados corretamente, você deve usar uma codificação Unicode, como UTF8Encoding ou UnicodeEncoding. Você também pode usar um protocolo de nível superior para garantir que o mesmo formato seja usado para codificação e decodificação.

A Default propriedade devolve sempre o UTF8Encoding. O UTF-8 é suportado em todos os sistemas operativos (Windows, Linux e macOS) onde as aplicações .NET correm.

Aplica-se a