Поделиться через

Console.OutputEncoding Свойство

Определение

Пространство имен:
System
Сборки:
netstandard.dll, System.Console.dll
Сборка:
System.Console.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll
Исходный код:
Console.cs
Исходный код:
Console.cs
Исходный код:
Console.cs
Исходный код:
Console.cs
Исходный код:
Console.cs

Возвращает или задает кодирование, используемое консолью для записи выходных данных.

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

Значение свойства

Encoding

Кодировка, используемая для записи выходных данных консоли.

Атрибуты
UnsupportedOSPlatformAttribute

Исключения

ArgumentNullException

Значение свойства в операции набора имеет значение null.

IOException

Произошла ошибка во время выполнения этой операции.

SecurityException

У приложения нет разрешения на выполнение этой операции.

Комментарии

В консоли используется кодирование выходных данных для перевода символов, написанных приложением, в соответствующие символы отображения консоли. Кодовая страница по умолчанию, которую использует консоль, определяется языковым стандартом системы.

Начиная с .NET Framework 4, операция получения свойства может возвращать кэшированное значение вместо текущей кодировки выходных данных консоли. Это может произойти, если значение OutputEncoding свойства изменяется каким-то образом, кроме назначения свойству OutputEncoding , например вызов функции Windows SetConsoleOutputCP .

Примечания для тех, кто вызывает этот метод

Из кодировк Юникода Console класс поддерживает кодировку UTF-8 с классом UTF8Encoding и, начиная с .NET Framework 4.5, он поддерживает кодировку UTF-16 с UnicodeEncoding помощью класса. Кодировка UTF-32 с классом UTF32Encoding не поддерживается. Попытка задать кодировку выходных данных для UTF-32 вызывает IOExceptionисключение.

Обратите внимание, что для успешного отображения символов Юникода в консоли требуется следующее:

  • Консоль должна использовать шрифт TrueType, например Lucida Console или Consolas, для отображения символов.

  • Шрифт, используемый консолью, должен определить конкретный глиф или глифы, которые должны отображаться. Консоль может использовать связывание шрифтов для отображения глифов из связанных шрифтов, если базовый шрифт не содержит определения для этого глифа.

Дополнительные сведения о поддержке кодировки Юникода в консоли см. в разделе "Поддержка Юникода для консоли" класса Console .

Применяется к