Udostępnij za pośrednictwem

Console.OutputEncoding Właściwość

Definicja

Przestrzeń nazw:
System
Zestawy:
netstandard.dll, System.Console.dll
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
Ź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; [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

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 danych wyjściowych do tłumaczenia znaków napisanych przez aplikację na odpowiednie znaki wyświetlane konsoli. Domyślna strona kodowa używana przez konsolę jest określana przez ustawienia regionalne systemu.

Począwszy od programu .NET Framework 4, operacja pobierania właściwości może zwrócić wartość buforowana zamiast bieżącego kodowania danych wyjściowych konsoli. Może się tak zdarzyć, jeśli wartość OutputEncoding właściwości jest modyfikowana za pomocą środków innych niż przypisanie do OutputEncoding właściwości, takich jak wywoływanie funkcji systemu Windows SetConsoleOutputCP .

Notatki dotyczące wywoływania

Z kodowań Console Unicode klasa obsługuje kodowanie UTF-8 z klasą UTF8Encoding i, począwszy od programu .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 danych wyjściowych na wartość UTF-32 zgłasza błąd IOException.

Pamiętaj, że pomyślne wyświetlenie znaków Unicode w konsoli wymaga następujących elementów:

  • 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 glyph lub glyphs, które mają być wyświetlane. Konsola może korzystać z łączenia czcionek w celu wyświetlania glifów z połączonych czcionek, 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