Sdílet prostřednictvím


Console.OutputEncoding Vlastnost

Definice

Získá nebo nastaví kódování konzoly k zápisu výstupu.

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; }
public static System.Text.Encoding OutputEncoding { get; [System.Runtime.Versioning.UnsupportedOSPlatform("android")] [System.Runtime.Versioning.UnsupportedOSPlatform("ios")] [System.Runtime.Versioning.UnsupportedOSPlatform("tvos")] set; }
static member OutputEncoding : System.Text.Encoding with 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
Public Shared Property OutputEncoding As Encoding

Hodnota vlastnosti

Kódování použité k zápisu výstupu konzoly.

Atributy

Výjimky

Hodnota vlastnosti v operaci set je null.

Při provádění této operace došlo k chybě.

Vaše aplikace nemá oprávnění k provedení této operace.

Poznámky

Konzola používá výstupní kódování k překladu znaků napsaných aplikací na odpovídající zobrazované znaky konzoly. Výchozí znaková stránka, kterou konzola používá, je určena národním prostředím systému.

Počínaje rozhraním .NET Framework 4 může operace získání vlastnosti vrátit hodnotu v mezipaměti místo aktuálního výstupního kódování konzoly. K tomu může dojít, pokud je hodnota OutputEncoding vlastnosti změněna jiným způsobem než přiřazením vlastnosti OutputEncoding , například voláním funkce systému Windows SetConsoleOutputCP .

Poznámky pro volající

Z kódování Console Unicode třída podporuje kódování UTF-8 s UTF8Encoding třídou a počínaje rozhraním .NET Framework 4.5 podporuje kódování UTF-16 s UnicodeEncoding třídou. Kódování UTF-32 s UTF32Encoding třídou není podporováno. Pokus o nastavení výstupního kódování na UTF-32 vyvolá .IOException

Všimněte si, že úspěšné zobrazení znaků Unicode v konzole vyžaduje následující:

  • Konzola musí k zobrazení znaků používat písmo TrueType, například Lucida Console nebo Consolas.

  • Písmo používané konzolou musí definovat konkrétní glyfy nebo glyfy, které se mají zobrazit. Konzola může využít propojení písem k zobrazení glyfů z propojených písem, pokud základní písmo neobsahuje definici tohoto glyfu.

Další informace o podpoře kódování Unicode konzolou najdete v části "Podpora unicode pro konzolu" ve Console třídě.

Platí pro