Console.OutputEncoding Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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ě.