Console.OutputEncoding Propiedad

Definición

Obtiene o establece la codificación que usa la consola para escribir la salida.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

Valor de propiedad

Encoding

Codificación usada para escribir la salida de la consola.The encoding used to write console output.

Excepciones

El valor de la propiedad en una operación de conjunto es null.The property value in a set operation is null.

Error durante la ejecución de esta operación.An error occurred during the execution of this operation.

Tu aplicación no tiene permiso para realizar esta operación.Your application does not have permission to perform this operation.

Comentarios

La consola de usa la codificación de salida para traducir los caracteres escritos por una aplicación en los caracteres de presentación de la consola correspondientes.The console uses the output encoding to translate characters written by an application into corresponding console display characters. La configuración regional del sistema determina la página de códigos predeterminada que utiliza la consola.The default code page that the console uses is determined by the system locale.

A partir de la .NET Framework 4, una operación get de propiedad puede devolver un valor almacenado en caché en lugar de la codificación de salida actual de la consola.Starting with the .NET Framework 4, a property get operation may return a cached value instead of the console's current output encoding. Esto puede ocurrir si el valor de la OutputEncoding propiedad es modificado por algunos medios distintos de una asignación a la OutputEncoding propiedad, como llamar a la función de 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.

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 la .NET Framework 4,5, admite la codificación UTF-16 con la UnicodeEncoding clase.Of the Unicode encodings, the Console class supports UTF-8 encoding with the UTF8Encoding class and, starting with the .NET Framework 4.5, it supports UTF-16 encoding with the UnicodeEncoding class. No se admite la codificación UTF-32 con la UTF32Encoding clase.UTF-32 encoding with the UTF32Encoding class is not supported. Al intentar establecer la codificación de salida en UTF-32, se produce una excepción IOException .Attempting to set the output encoding to UTF-32 throws an IOException.

Tenga en cuenta que la visualización correcta de caracteres Unicode en la consola requiere lo siguiente:Note that successfully displaying Unicode characters to the console requires the following:

-La consola debe usar una fuente TrueType, como lucida Console o consolas, para mostrar caracteres.- The console must use a TrueType font, such as Lucida Console or Consolas, to display characters.

: Una fuente usada por la consola debe definir el glifo o glifos determinados que se van a mostrar.- A font used by the console must define the particular glyph or glyphs to be displayed. La consola puede aprovechar la vinculación de fuentes para mostrar glifos de fuentes vinculadas si la fuente base no contiene una definición para ese glifo.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.

Para obtener más información sobre la compatibilidad con la codificación Unicode en la consola de, vea la sección "compatibilidad con Unicode para la consola" en la Console clase.For more information about support for Unicode encoding by the console, see the "Unicode Support for the Console" section in the Console class.

Se aplica a