Console.OutputEncoding Propriedade

Definição

Obtém ou define a codificação que a consola usa para escrever 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; set; }
static member OutputEncoding : System.Text.Encoding with get, set
Public Shared Property OutputEncoding As Encoding

Valor de Propriedade

A codificação usada para escrever a saída da consola.

Exceções

O valor de propriedade numa operação de conjunto é null.

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

A sua candidatura não tem permissão para realizar esta operação.

Observações

A consola utiliza a codificação de saída para traduzir caracteres escritos por uma aplicação em caracteres correspondentes de visualização da consola. A página de códigos padrão que a consola usa é determinada pela localização do sistema.

A partir do .NET Framework 4, uma operação de obtenção de propriedades pode devolver um valor em cache em vez da codificação de saída atual da consola. Isto pode ocorrer se o valor da propriedade OutputEncoding for modificado por algum meio que não seja uma atribuição à propriedade OutputEncoding, como chamar a função Windows SetConsoleOutputCP.

Notas para Chamadores

Das codificações Unicode, a classe Console suporta codificação UTF-8 com a classe UTF8Encoding e, a partir do .NET Framework 4.5, suporta codificação UTF-16 com a classe UnicodeEncoding. A codificação UTF-32 com a UTF32Encoding classe não é suportada. Tentar definir a codificação de saída para UTF-32 gera um IOException.

Note que para mostrar com sucesso caracteres Unicode na consola requer o seguinte:

  • A consola deve usar uma fonte TrueType, como Lucida Console ou Consolas, para mostrar os caracteres.

  • Uma fonte usada pela consola deve definir o glifo ou glifos específicos a serem exibidos. A consola pode tirar partido da ligação de fontes para mostrar glifos de fontes ligadas se a fonte base não contiver uma definição para esse glifo.

Para mais informações sobre o suporte à codificação Unicode pela consola, consulte a secção "Suporte Unicode para a Consola" na Console classe.

Aplica-se a