Sdílet prostřednictvím

Console.OutputEncoding Vlastnost

Definice

Obor názvů:
System
Sestavení:
netstandard.dll, System.Console.dll
Sestavení:
System.Console.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll
Zdroj:
Console.cs
Zdroj:
Console.cs
Zdroj:
Console.cs
Zdroj:
Console.cs
Zdroj:
Console.cs

Získá nebo nastaví kódování, které konzola používá 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; [System.Runtime.Versioning.UnsupportedOSPlatform("android")] [System.Runtime.Versioning.UnsupportedOSPlatform("ios")] [System.Runtime.Versioning.UnsupportedOSPlatform("tvos")] set; }
public static System.Text.Encoding OutputEncoding { 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
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 sady je null.

IOException

Během provádění této operace došlo k chybě.

SecurityException

Aplikace nemá oprávnění k provedení této operace.

Poznámky

Konzola používá výstupní kódování k překladu znaků zapsaných aplikací do odpovídajících znaků zobrazení 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 uloženou v mezipaměti místo aktuálního kódování výstupu konzoly. K tomu může dojít v případě, že hodnota OutputEncoding vlastnosti je změněna jiným způsobem než přiřazením k OutputEncoding vlastnosti, například volání funkce 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á chybu IOException.

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

  • Konzola musí k zobrazení znaků použít 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 pomocí konzoly naleznete v části "Podpora kódování Unicode pro konzolu Console " ve třídě.

Platí pro