Udostępnij za pośrednictwem

Console.OutputEncoding Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System
Zestaw:
System.Console.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll
Źródło:
Console.cs
Źródło:
Console.cs
Źródło:
Console.cs

Pobiera lub ustawia kodowanie używane przez konsolę do zapisywania danych wyjściowych.

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

Wartość właściwości

Encoding

Kodowanie używane do zapisywania danych wyjściowych konsoli.

Atrybuty
UnsupportedOSPlatformAttribute

Wyjątki

ArgumentNullException

Wartość właściwości w operacji zestawu to null.

IOException

Wystąpił błąd podczas wykonywania tej operacji.

SecurityException

Aplikacja nie ma uprawnień do wykonania tej operacji.

Uwagi

Konsola używa kodowania wyjściowego do tłumaczenia znaków napisanych przez aplikację na odpowiednie znaki wyświetlania konsoli. Domyślna strona kodowa używana przez konsolę jest określana przez ustawienia regionalne systemu.

Począwszy od .NET Framework 4, operacja pobierania właściwości może zwrócić wartość buforowanej zamiast bieżącego kodowania wyjściowego konsoli. Może się to zdarzyć, jeśli wartość OutputEncoding właściwości jest modyfikowana w sposób inny niż przypisanie do OutputEncoding właściwości, na przykład wywoływanie funkcji systemu Windows SetConsoleOutputCP .

Uwagi dotyczące wywoływania

Z kodowań Console Unicode klasa obsługuje kodowanie UTF-8 z klasą UTF8Encoding i, począwszy od .NET Framework 4.5, obsługuje kodowanie UTF-16 z klasąUnicodeEncoding. Kodowanie UTF-32 z klasą UTF32Encoding nie jest obsługiwane. Próba ustawienia kodowania wyjściowego na wartość UTF-32 zgłasza błąd IOException.

Należy pamiętać, że pomyślne wyświetlenie znaków Unicode w konsoli wymaga następujących czynności:

  • Konsola musi używać czcionki TrueType, takiej jak Lucida Console lub Consolas, do wyświetlania znaków.

  • Czcionka używana przez konsolę musi definiować określone glify lub glify do wyświetlenia. Konsola może korzystać z linków czcionek do wyświetlania glifów z czcionek połączonych, jeśli czcionka podstawowa nie zawiera definicji tego glif.

Aby uzyskać więcej informacji na temat obsługi kodowania Unicode przez konsolę, zobacz sekcję "Obsługa Unicode dla konsoli" w Console klasie .

Dotyczy