Console.OutputEncoding Свойство

  • Ссылка

Определение

Пространство имен:
System
Сборка:
System.Console.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll
Исходный код:
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; 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

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

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 .

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