Console::InputEncoding Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets or sets the encoding the console uses to read input.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

public:
property Encoding^ InputEncoding {
	static Encoding^ get();
	static void set(Encoding^ value);
}

Property Value

Type: System.Text::Encoding^

The encoding used to read console input.

Exception Condition
ArgumentNullException

The property value in a set operation is null.

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 input encoding to translate keyboard input into a corresponding character. The input encoding incorporates a code page that maps 256 keyboard character codes to individual characters. Different code pages include different special characters, typically customized for a language or a group of languages.

Starting with the .NET Framework 4, a property get operation may return a cached value instead of the console's current input encoding. This can occur if the value of the InputEncoding property is modified by some means other than an assignment to the InputEncoding property, such as calling the Windows SetConsoleCP function or using the chcp command from a PowerShell script.

UIPermission

for reading and writing to top-level windows and subwindows. Associated enumeration: UIPermissionWindow::SafeTopLevelWindows

.NET Framework
Available since 2.0
Return to top
Show: