Console.OutputEncoding Tulajdonság

Definíció

Névtér:
System
Szerelvények:
netstandard.dll, System.Console.dll
Szerelvény:
System.Console.dll
Szerelvény:
mscorlib.dll
Szerelvény:
netstandard.dll
Forrás:
Console.cs
Forrás:
Console.cs
Forrás:
Console.cs
Forrás:
Console.cs
Forrás:
Console.cs

Lekéri vagy beállítja a konzol által a kimenet írásához használt kódolást.

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

Tulajdonság értéke

Encoding

A konzol kimenetének írásához használt kódolás.

Attribútumok
UnsupportedOSPlatformAttribute

Kivételek

ArgumentNullException

A halmazművelet tulajdonságértéke a következő null: .

IOException

Hiba történt a művelet végrehajtása során.

SecurityException

Az alkalmazásnak nincs engedélye a művelet végrehajtására.

Megjegyzések

A konzol a kimeneti kódolással lefordítja az alkalmazás által írt karaktereket a megfelelő konzolmegjelenítési karakterekre. A konzol által használt alapértelmezett kódlapot a rendszer területi beállítása határozza meg.

A .NET Framework 4-től kezdve a tulajdonság lekérési művelete gyorsítótárazott értéket adhat vissza a konzol aktuális kimeneti kódolása helyett. Ez akkor fordulhat elő, ha a OutputEncoding tulajdonság értékét a OutputEncoding tulajdonsághoz való hozzárendelésen kívül más módon módosítja, például meghívja a Windows SetConsoleOutputCP függvényt.

Megjegyzések a hívókhoz

A Unicode-kódolások közül a Console osztály támogatja az UTF-8 kódolást az UTF8Encoding osztálysal, és a .NET Framework 4.5-től kezdve támogatja az UTF-16 kódolást a UnicodeEncoding osztálysal. Az osztály UTF-32 kódolása UTF32Encoding nem támogatott. Ha megkísérli beállítani a kimeneti kódolást UTF-32 értékre, egy IOException.

Vegye figyelembe, hogy a Unicode-karakterek konzolon való sikeres megjelenítéséhez a következőkre van szükség:

  • A konzolnak TrueType betűtípust (például Lucida-konzolt vagy Consolast) kell használnia a karakterek megjelenítéséhez.

  • A konzol által használt betűtípusnak meg kell határoznia a megjelenítendő karakterjeleket vagy karakterjeleket. A konzol kihasználhatja a betűtípus-csatolás előnyeit a csatolt betűtípusokból származó karakterjelek megjelenítéséhez, ha az alap betűtípus nem tartalmaz definíciót az adott karakterjelhez.

A Unicode kódolás konzol általi támogatásáról az osztály "Unicode-támogatás a konzolhoz" című szakaszában Console talál további információt.

A következőre érvényes: