Console.OutputEncoding Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.