Console.OutputEncoding Vlastnost

Reference

Definice

Obor názvů:: System

Sestavení:: System.Console.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Zdroj:: Console.cs

Zdroj:: Console.cs

Zdroj:: Console.cs

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

Encoding

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

Atributy: UnsupportedOSPlatformAttribute

Výjimky

ArgumentNullException

Hodnota vlastnosti v operaci set je null.

IOException

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

SecurityException

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