Console::OutputEncoding Property
Updated: March 2012
Gets or sets the encoding the console uses to write output.
Assembly: mscorlib (in mscorlib.dll)
| Exception | Condition |
|---|---|
| ArgumentNullException | The property value in a set operation is nullptr. |
| PlatformNotSupportedException | This property's set operation is not supported on Windows 98, Windows 98 Second Edition, or Windows Millennium Edition. |
| IOException | An error occurred during the execution of this operation. |
| SecurityException | 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 output encoding incorporates a code page that maps 256 characters to individual console display characters. Different code pages include different special characters, typically customized for a language or a group of languages.
Starting with the .NET Framework version 4, a property get operation may return a cached value rather than the console's current output encoding. 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.
- UIPermission
for reading and writing to top-level windows and subwindows. Associated enumeration: UIPermissionWindow::SafeTopLevelWindows
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.