Console.OutputEncoding Propiedad

  • Referencia

Definición

Espacio de nombres:
System
Ensamblado:
System.Console.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll

Obtiene o establece la codificación que usa la consola para escribir la salida.

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

Valor de propiedad

Encoding

Codificación usada para escribir la salida de la consola.

Atributos
UnsupportedOSPlatformAttribute

Excepciones

ArgumentNullException

El valor de la propiedad en una operación de conjunto es null.

IOException

Error durante la ejecución de esta operación.

SecurityException

Tu aplicación no tiene permiso para realizar esta operación.

Comentarios

La consola usa la codificación de salida para traducir caracteres escritos por una aplicación en los caracteres de visualización de consola correspondientes. La página de códigos predeterminada que usa la consola viene determinada por la configuración regional del sistema.

A partir de .NET Framework 4, una operación de obtención de propiedades puede devolver un valor almacenado en caché en lugar de la codificación de salida actual de la consola. Esto puede ocurrir si el valor de la OutputEncoding propiedad se modifica por algún medio distinto de una asignación a la OutputEncoding propiedad, como llamar a la función WindowsSetConsoleOutputCP.

Notas a los autores de las llamadas

De las codificaciones Unicode, la Console clase admite la codificación UTF-8 con la UTF8Encoding clase y, a partir de .NET Framework 4.5, admite la codificación UTF-16 con la UnicodeEncoding clase . No se admite la codificación UTF-32 con la UTF32Encoding clase . Si se intenta establecer la codificación de salida en UTF-32, se produce una IOExceptionexcepción .

Tenga en cuenta que la visualización correcta de caracteres Unicode en la consola requiere lo siguiente:

  • La consola debe usar una fuente TrueType, como Lucida Console o Consolas, para mostrar caracteres.

  • Una fuente utilizada por la consola debe definir el glifo o glifos concretos que se van a mostrar. La consola puede aprovechar la vinculación de fuente para mostrar glifos de fuentes vinculadas si la fuente base no contiene una definición para ese glifo.

Para obtener más información sobre la compatibilidad con la codificación Unicode por la consola, vea la sección "Compatibilidad con Unicode para la consola" de la Console clase .

Se aplica a