Console.OutputEncoding Propriedade

Definição

Namespace:

System

Assembly:

System.Console.dll

Origem:

Console.cs

Obtém ou define a codificação usada pelo console 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; }

[<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

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 conjuntos é null.

IOException

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

SecurityException

O 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 poderá ocorrer se o valor da OutputEncoding propriedade for modificado por alguns meios diferentes de uma atribuição à OutputEncoding propriedade, como chamar a função do Windows SetConsoleOutputCP .

Notas aos Chamadores

Das codificações Unicode, a Console classe dá suporte à codificação UTF-8 com a UTF8Encoding classe e, começando com o .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 a exibição bem-sucedida de caracteres Unicode no console requer o seguinte:

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

• Uma fonte usada pelo console deve definir o glifo ou glifos específicos a serem exibidos. O console pode aproveitar a vinculação de fontes 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 para codificação Unicode pelo console, consulte a seção "Suporte Unicode para o Console" na Console classe .