Console.OutputEncoding Console.OutputEncoding Console.OutputEncoding Console.OutputEncoding Property

Определение

Получает или задает кодировку консоли, используемую при записи выходных данных.Gets or sets the encoding the console uses to write output.

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; }
member this.OutputEncoding : System.Text.Encoding with get, set
Public Shared Property OutputEncoding As Encoding

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

Кодировка консоли, используемая при записи вывода.The encoding used to write console output.

Исключения

Значение свойства в операции задания — null.The property value in a set operation is null.

Во время выполнения этой операции произошла ошибка.An error occurred during the execution of this operation.

У приложения нет разрешения на выполнение этой операции.Your application does not have permission to perform this operation.

Комментарии

Консоль использует кодировку вывода для преобразования символов, записываемых приложением, в соответствующие символы отображения консоли.The console uses the output encoding to translate characters written by an application into corresponding console display characters. Кодовая страница по умолчанию, который использует консоль определяется языкового стандарта системы.The default code page that the console uses is determined by the system locale.

Начиная с .NET Framework 4.NET Framework 4, операция получения свойство может возвращать кэшированное значение вместо текущая кодировка выходной консоли.Starting with the .NET Framework 4.NET Framework 4, a property get operation may return a cached value instead of the console's current output encoding. Это может произойти, если значение OutputEncoding свойство изменяется каким-либо образом, отличный от присвоения OutputEncoding свойство, например вызов Windows SetConsoleOutputCP функции.This can occur if the value of the OutputEncoding property is modified by some means other than an assignment to the OutputEncoding property, such as calling the Windows SetConsoleOutputCP function.

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

Кодировок Юникода Console класс поддерживает кодирование с помощью UTF-8 UTF8Encoding класса и, начиная с .NET Framework 4.5.NET Framework 4.5, он поддерживает кодирование с помощью UTF-16 UnicodeEncoding класса.Of the Unicode encodings, the Console class supports UTF-8 encoding with the UTF8Encoding class and, starting with the .NET Framework 4.5.NET Framework 4.5, it supports UTF-16 encoding with the UnicodeEncoding class. Кодировка UTF-32 с UTF32Encoding класс не поддерживается.UTF-32 encoding with the UTF32Encoding class is not supported. Попытка задать выходных данных кодировку UTF-32 вызывает IOException.Attempting to set the output encoding to UTF-32 throws an IOException.

Обратите внимание на то, что успешно отображение символов Юникода в консоль требуется следующее:Note that successfully displaying Unicode characters to the console requires the following: -Консоли необходимо использовать шрифт TrueType, например Lucida Console или Consolas, для отображения символов.- The console must use a TrueType font, such as Lucida Console or Consolas, to display characters.

-Шрифта, используемого этим консоли необходимо определить конкретного глиф или глифов для отображения.- A font used by the console must define the particular glyph or glyphs to be displayed. Консоль можно воспользоваться преимуществами связь для отображения глифов из связанных шрифтов, если базового шрифта не содержит определение для Этот глиф шрифтов.The console can take advantage of font linking to display glyphs from linked fonts if the base font does not contain a definition for that glyph.

Дополнительные сведения о поддержке Юникода в кодировку, консоли, см. в разделе «Юникода поддержки для консоль» в Console класса.For more information about support for Unicode encoding by the console, see the "Unicode Support for the Console" section in the Console class.

Безопасность

UIPermission
для чтения и записи для окон верхнего уровня и подокнах.for reading and writing to top-level windows and subwindows. Связанное перечисление: SafeTopLevelWindowsAssociated enumeration: SafeTopLevelWindows

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