Partilhar via

Console.OutputEncoding Propriedade

Definição

Namespace:
System
Assemblies:
netstandard.dll, System.Console.dll
Assembly:
System.Console.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Origem:
Console.cs
Origem:
Console.cs
Origem:
Console.cs
Origem:
Console.cs
Origem:
Console.cs

Obtém ou define a codificação que o console usa para gravar a saída.

public:
 static property System::Text::Encoding ^ OutputEncoding { System::Text::Encoding ^ get(); void set(System::Text::Encoding ^ value); };
public static System.Text.Encoding OutputEncoding { get; [System.Runtime.Versioning.UnsupportedOSPlatform("android")] [System.Runtime.Versioning.UnsupportedOSPlatform("ios")] [System.Runtime.Versioning.UnsupportedOSPlatform("tvos")] set; }
public static System.Text.Encoding OutputEncoding { get; set; }
[<set: System.Runtime.Versioning.UnsupportedOSPlatform("android")>]
[<set: System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<set: System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
static member OutputEncoding : System.Text.Encoding with get, set
static member OutputEncoding : System.Text.Encoding with get, set
Public Shared Property OutputEncoding As Encoding

Valor da propriedade

Encoding

A codificação usada para gravar a saída do console.

Atributos
UnsupportedOSPlatformAttribute

Exceções

ArgumentNullException

O valor da propriedade em uma operação de conjunto é null.

IOException

Ocorreu um erro durante a execução desta operação.

SecurityException

Seu aplicativo não tem permissão para executar essa operação.

Comentários

O console usa a codificação de saída para traduzir caracteres gravados por um aplicativo em caracteres de exibição de console correspondentes. A página de código padrão que o console usa é determinada pela localidade do sistema.

A partir do .NET Framework 4, uma operação de obtenção de propriedade pode retornar um valor armazenado em cache em vez da codificação de saída atual do console. Isso pode ocorrer se o valor da OutputEncoding propriedade for modificado por alguns meios diferentes de uma atribuição à OutputEncoding propriedade, como chamar a função windows SetConsoleOutputCP .

Notas aos Chamadores

Das codificações Unicode, a Console classe dá suporte à codificação UTF-8 com a UTF8Encoding classe e, a partir do .NET Framework 4.5, dá suporte à codificação UTF-16 com a UnicodeEncoding classe. Não há suporte para codificação UTF-32 com a UTF32Encoding classe. Tentar definir a codificação de saída como UTF-32 gera um IOException.

Observe que exibir caracteres Unicode com êxito no console requer o seguinte:

  • O console deve usar uma fonte TrueType, como o Console lucida ou Consolas, para exibir caracteres.

  • Uma fonte usada pelo console deve definir o glifo ou glifo específico a ser exibido. O console pode aproveitar a vinculação de fonte para exibir glifos de fontes vinculadas se a fonte base não contiver uma definição para esse glifo.

Para obter mais informações sobre o suporte à codificação Unicode pelo console, consulte a seção "Suporte Unicode para o Console" na Console classe.

Aplica-se a