Encoding.Default Propriedade

Definição

Obtém a codificação padrão para essa implementação do .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 da propriedade

A codificação padrão para essa implementação do .NET.

Comentários

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

  • No .NET Framework: retorna a codificação que corresponde à página de código ativo do sistema. Essa é a mesma codificação retornada GetEncoding(Int32) quando chamada com um codepage argumento de 0.

  • No .NET Core e em versões posteriores: Sempre retorna um UTF8Encoding objeto. Esse comportamento foi alterado para incentivar o uso de codificações Unicode para melhor compatibilidade entre plataformas e integridade de dados.

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

Aviso

Computadores diferentes podem usar codificações diferentes como o padrão e a codificação padrão pode ser alterada em um único computador. Se você usar a Encoding.Default codificação para codificar e decodificar dados transmitidos entre computadores ou recuperados em momentos diferentes no mesmo computador, isso poderá traduzir esses dados incorretamente. Além disso, a codificação retornada pela propriedade Default usa fallback de melhor ajuste para mapear caracteres não suportados para caracteres suportados pela página de código. Por esses motivos, não é recomendável usar a codificação padrão. 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 sempre retorna o UTF8Encoding. O UTF-8 tem suporte em todos os sistemas operacionais (Windows, Linux e macOS) nos quais .NET aplicativos são executados.

Aplica-se a