Exportar (0) Imprimir
Expandir todo
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original

Console (Clase)

Representa los flujos de entrada, salida y error estándar para las aplicaciones de consola. Esta clase no puede heredarse.

Espacio de nombres:  System
Ensamblado:  mscorlib (en mscorlib.dll)

public static class Console

El tipo Console expone los siguientes miembros.

  NombreDescripción
Propiedad públicaMiembro estáticoBackgroundColorObtiene o establece el color de fondo de la consola.
Propiedad públicaMiembro estáticoBufferHeightObtiene o establece el alto del área del búfer.
Propiedad públicaMiembro estáticoBufferWidthObtiene o establece el ancho del área del búfer.
Propiedad públicaMiembro estáticoCapsLockObtiene un valor que indica si se activa o desactiva la alternancia de teclado de BLOQ MAYÚS.
Propiedad públicaMiembro estáticoCursorLeftObtiene o establece la posición en columnas del cursor en el área del búfer.
Propiedad públicaMiembro estáticoCursorSizeObtiene o establece el alto del cursor en una celda de carácter.
Propiedad públicaMiembro estáticoCursorTopObtiene o establece la posición en filas del cursor en el área del búfer.
Propiedad públicaMiembro estáticoCursorVisibleObtiene o establece un valor que indica si el cursor es visible.
Propiedad públicaMiembro estáticoCompatible con XNA FrameworkErrorObtiene el flujo de salida de error estándar.
Propiedad públicaMiembro estáticoForegroundColorObtiene o establece el color de primer plano de la consola.
Propiedad públicaMiembro estáticoCompatible con XNA FrameworkInObtiene el flujo de entrada estándar.
Propiedad públicaMiembro estáticoInputEncodingObtiene o establece la codificación que utiliza la consola para leer la entrada.
Propiedad públicaMiembro estáticoKeyAvailableObtiene un valor que indica si hay disponible una acción de presionar una tecla en el flujo de entrada.
Propiedad públicaMiembro estáticoLargestWindowHeightObtiene el máximo número posible de filas para la ventana de la consola, basado en la fuente y la resolución de pantalla actuales.
Propiedad públicaMiembro estáticoLargestWindowWidthObtiene el máximo número posible de columnas para la ventana de la consola, basado en la fuente y la resolución de pantalla actuales.
Propiedad públicaMiembro estáticoNumberLockObtiene un valor que indica si está activada o desactivada la alternancia de teclado de BLOQ NUM.
Propiedad públicaMiembro estáticoCompatible con XNA FrameworkOutObtiene el flujo de salida estándar.
Propiedad públicaMiembro estáticoOutputEncodingObtiene o establece la codificación que utiliza la consola para escribir la salida.
Propiedad públicaMiembro estáticoTitleObtiene o establece el título que se va a mostrar en la barra de título de la consola.
Propiedad públicaMiembro estáticoTreatControlCAsInputObtiene o establece un valor que indica si la combinación de la tecla modificadora Control y de la tecla de consola C (CTRL+C) se trata como una entrada ordinaria o como una interrupción controlada por el sistema operativo.
Propiedad públicaMiembro estáticoWindowHeightObtiene o establece el alto del área de la ventana de la consola.
Propiedad públicaMiembro estáticoWindowLeftObtiene o establece la posición más a la izquierda del área de la ventana de la consola con respecto al búfer de pantalla.
Propiedad públicaMiembro estáticoWindowTopObtiene o establece la posición superior del área de la ventana de la consola con respecto al búfer de pantalla.
Propiedad públicaMiembro estáticoWindowWidthObtiene o establece el ancho de la ventana de la consola.
Arriba

  NombreDescripción
Método públicoMiembro estáticoBeep()Reproduce el sonido de un bip a través del altavoz de la consola.
Método públicoMiembro estáticoBeep(Int32, Int32)Reproduce el sonido de un bip con una frecuencia y duración especificadas a través del altavoz de la consola.
Método públicoMiembro estáticoClearBorra la información que se muestra en el búfer de pantalla y en la correspondiente ventana de la consola.
Método públicoMiembro estáticoMoveBufferArea(Int32, Int32, Int32, Int32, Int32, Int32)Copia un área de origen especificada del búfer de pantalla en un área de destino determinada.
Método públicoMiembro estáticoMoveBufferArea(Int32, Int32, Int32, Int32, Int32, Int32, Char, ConsoleColor, ConsoleColor)Copia un área de origen especificada del búfer de pantalla en un área de destino determinada.
Método públicoMiembro estáticoOpenStandardError()Adquiere el flujo de error estándar.
Método públicoMiembro estáticoOpenStandardError(Int32)Adquiere el flujo de error estándar, que se establece en un tamaño de búfer especificado.
Método públicoMiembro estáticoOpenStandardInput()Adquiere el flujo de entrada estándar.
Método públicoMiembro estáticoOpenStandardInput(Int32)Adquiere el flujo de entrada estándar, que se establece en un tamaño de búfer especificado.
Método públicoMiembro estáticoOpenStandardOutput()Adquiere el flujo de salida estándar.
Método públicoMiembro estáticoOpenStandardOutput(Int32)Adquiere el flujo de salida estándar, que se establece en un tamaño de búfer especificado.
Método públicoMiembro estáticoReadLee el siguiente carácter del flujo de entrada estándar.
Método públicoMiembro estáticoReadKey()Obtiene la siguiente tecla de carácter o de función presionada por el usuario. La tecla presionada se muestra en la ventana de la consola.
Método públicoMiembro estáticoReadKey(Boolean)Obtiene la siguiente tecla de carácter o de función presionada por el usuario. Opcionalmente, la tecla presionada se muestra en la ventana de la consola.
Método públicoMiembro estáticoCompatible con XNA FrameworkReadLineLee la siguiente línea de caracteres del flujo de entrada estándar.
Método públicoMiembro estáticoResetColorEstablece los colores de primer plano y de fondo de la consola en sus valores predeterminados.
Método públicoMiembro estáticoSetBufferSizeEstablece el alto y el ancho del área del búfer de pantalla en los valores especificados.
Método públicoMiembro estáticoSetCursorPositionEstablece la posición del cursor.
Método públicoMiembro estáticoCompatible con XNA FrameworkSetErrorEstablece la propiedad Error en el objeto TextWriter especificado.
Método públicoMiembro estáticoCompatible con XNA FrameworkSetInEstablece la propiedad In en el objeto TextReader especificado.
Método públicoMiembro estáticoCompatible con XNA FrameworkSetOutEstablece la propiedad Out en el objeto TextWriter especificado.
Método públicoMiembro estáticoSetWindowPositionEstablece la posición de la ventana de la consola con respecto al búfer de pantalla.
Método públicoMiembro estáticoSetWindowSizeEstablece el alto y el ancho de la ventana de la consola en los valores especificados.
Método públicoMiembro estáticoWrite(Boolean)Escribe la representación de texto del valor Boolean especificado en el flujo de salida estándar.
Método públicoMiembro estáticoCompatible con XNA FrameworkWrite(Char)Escribe el valor del carácter Unicode especificado en el flujo de salida estándar.
Método públicoMiembro estáticoCompatible con XNA FrameworkWrite(Char[])Escribe la matriz especificada de caracteres Unicode en el flujo de salida estándar.
Método públicoMiembro estáticoWrite(Decimal)Escribe la representación de texto del valor Decimal especificado en el flujo de salida estándar.
Método públicoMiembro estáticoWrite(Double)Escribe la representación de texto del valor de punto flotante de precisión doble especificado en el flujo de salida estándar.
Método públicoMiembro estáticoCompatible con XNA FrameworkWrite(Int32)Escribe la representación de texto del valor entero de 32 bits con signo especificado en el flujo de salida estándar.
Método públicoMiembro estáticoWrite(Int64)Escribe la representación de texto del valor entero de 64 bits con signo especificado en el flujo de salida estándar.
Método públicoMiembro estáticoCompatible con XNA FrameworkWrite(Object)Escribe la representación de texto del objeto especificado en el flujo de salida estándar.
Método públicoMiembro estáticoWrite(Single)Escribe la representación de texto del valor de punto flotante de precisión sencilla especificado en el flujo de salida estándar.
Método públicoMiembro estáticoCompatible con XNA FrameworkWrite(String)Escribe el valor de cadena especificado en el flujo de salida estándar.
Método públicoMiembro estáticoWrite(UInt32)Escribe la representación de texto del valor entero de 32 bits sin signo especificado en el flujo de salida estándar.
Método públicoMiembro estáticoWrite(UInt64)Escribe la representación de texto del valor entero de 64 bits sin signo especificado en el flujo de salida estándar.
Método públicoMiembro estáticoCompatible con XNA FrameworkWrite(String, Object)Escribe la representación de texto del objeto especificado en el flujo de salida estándar utilizando la información de formato indicada.
Método públicoMiembro estáticoCompatible con XNA FrameworkWrite(String, Object[])Escribe la representación de texto de la matriz de objetos especificada en el flujo de salida estándar utilizando la información de formato especificada.
Método públicoMiembro estáticoCompatible con XNA FrameworkWrite(Char[], Int32, Int32)Escribe la submatriz de caracteres Unicode especificada en el flujo de salida estándar.
Método públicoMiembro estáticoCompatible con XNA FrameworkWrite(String, Object, Object)Escribe la representación de texto de los objetos especificados en el flujo de salida estándar utilizando la información de formato indicada.
Método públicoMiembro estáticoCompatible con XNA FrameworkWrite(String, Object, Object, Object)Escribe la representación de texto de los objetos especificados en el flujo de salida estándar utilizando la información de formato indicada.
Método públicoMiembro estáticoWrite(String, Object, Object, Object, Object)Escribe la representación de texto de los objetos especificados y la lista de parámetros de longitud variable en el flujo de salida estándar utilizando la información de formato especificada.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteLine()Escribe el terminador de línea actual en el flujo de salida estándar.
Método públicoMiembro estáticoWriteLine(Boolean)Escribe la representación de texto del valor Boolean especificado, seguida del terminador de línea actual, en el flujo de salida estándar.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteLine(Char)Escribe el carácter Unicode especificado, seguido del terminador de línea actual, en el flujo de salida estándar.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteLine(Char[])Escribe la matriz de caracteres Unicode especificada, seguida del terminador de línea actual, en el flujo de salida estándar.
Método públicoMiembro estáticoWriteLine(Decimal)Escribe la representación de texto del valor Decimal especificado, seguido del terminador de línea actual, en el flujo de salida estándar.
Método públicoMiembro estáticoWriteLine(Double)Escribe la representación de texto del valor de punto flotante de precisión doble especificado, seguido del terminador de línea actual, en el flujo de salida estándar.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteLine(Int32)Escribe la representación de texto del valor entero de 32 bits con signo especificado, seguido del terminador de línea actual, en el flujo de salida estándar.
Método públicoMiembro estáticoWriteLine(Int64)Escribe la representación de texto del valor entero de 64 bits con signo especificado, seguido del terminador de línea actual, en el flujo de salida estándar.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteLine(Object)Escribe la representación de texto del objeto especificado, seguida del terminador de línea actual, en el flujo de salida estándar.
Método públicoMiembro estáticoWriteLine(Single)Escribe la representación de texto del valor de punto flotante de precisión sencilla especificado, seguido del terminador de línea actual, en el flujo de salida estándar.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteLine(String)Escribe el valor de cadena especificado, seguido del terminador de línea actual, en el flujo de salida estándar.
Método públicoMiembro estáticoWriteLine(UInt32)Escribe la representación de texto del valor entero de 32 bits sin signo especificado, seguido del terminador de línea actual, en el flujo de salida estándar.
Método públicoMiembro estáticoWriteLine(UInt64)Escribe la representación de texto del valor entero de 64 bits sin signo especificado, seguido del terminador de línea actual, en el flujo de salida estándar.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteLine(String, Object)Escribe la representación de texto del objeto especificado, seguida del terminador de línea actual, en el flujo de salida estándar utilizando la información de formato especificada.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteLine(String, Object[])Escribe la representación de texto de la matriz de objetos especificada, seguida del terminador de línea actual, en el flujo de salida estándar utilizando la información de formato especificada.
Método públicoMiembro estáticoWriteLine(Char[], Int32, Int32)Escribe la submatriz de caracteres Unicode especificada, seguida del terminador de línea actual, en el flujo de salida estándar.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteLine(String, Object, Object)Escribe la representación de texto de los objetos especificados, seguida del terminador de línea actual, en el flujo de salida estándar utilizando la información de formato especificada.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteLine(String, Object, Object, Object)Escribe la representación de texto de los objetos especificados, seguida del terminador de línea actual, en el flujo de salida estándar utilizando la información de formato especificada.
Método públicoMiembro estáticoWriteLine(String, Object, Object, Object, Object)Escribe la representación de texto de los objetos especificados y la lista de parámetros de longitud variable, seguidas del terminador de línea actual, en el flujo de salida estándar utilizando la información de formato especificada.
Arriba

  NombreDescripción
Evento públicoMiembro estáticoCancelKeyPressSe produce cuando la tecla modificadora Control (CTRL) y la tecla de consola C (C) se presionan simultáneamente (CTRL+C).
Arriba

La consola es una ventana del sistema operativo en la que los usuarios interactúan con el sistema operativo o con una aplicación de consola basada en texto, escribiendo entradas de texto mediante el teclado del equipo y leyendo las salidas de texto del terminal del equipo. Por ejemplo, en Windows, la consola se denomina ventana de símbolo del sistema y acepta comandos en MS-DOS. La clase Console proporciona una compatibilidad básica para las aplicaciones que leen y escriben caracteres en la consola.

Flujos de E/S de la consola

Cuando se inicia una aplicación de consola, el sistema operativo asocia automáticamente a la consola tres flujos de E/S. La aplicación puede leer las entradas del usuario provenientes del flujo de entrada estándar, escribir datos normales en el flujo de salida estándar y escribir datos de error en el flujo de salida de error estándar. Estos flujos se presentan a la aplicación como los valores de las propiedades In, Out y Error.

De manera predeterminada, el valor de la propiedad In es un objeto System.IO.TextReader y los valores de las propiedades Out y Error son objetos System.IO.TextWriter. No obstante, se pueden establecer estas propiedades en flujos que no representen la consola; por ejemplo, es posible establecer estas propiedades en flujos que representen archivos. Para redirigir la entrada estándar, el resultado estándar o el flujo de error estándar, llame al método SetIn, SetError o SetOut, respectivamente. Las operaciones de E/S que utilizan estos flujos están sincronizadas, lo que significa que varios subprocesos pueden leer los flujos o escribir en ellos.

NotaNota

No debe utilizar la clase Console para mostrar el resultado en aplicaciones desatendidas, por ejemplo en las aplicaciones de servidor. De igual forma, las llamadas a métodos como Write y WriteLine no tienen ningún efecto en las aplicaciones para Windows.

Los miembros de la clase Console que funcionan normalmente cuando el flujo subyacente se dirige a una consola pueden producir una excepción si el flujo se redirige, por ejemplo, a un archivo. Por consiguiente, conviene programar la aplicación para que detecte una excepción System.IO.IOException si se redirige una flujo estándar.

A veces resulta útil llamar explícitamente a los miembros de los objetos de flujo representados por las propiedades In, Out y Error. Por ejemplo, de forma predeterminada, el método Console.ReadLine lee la entrada del flujo de entrada estándar. Del mismo modo, el método Console.WriteLine escribe los datos en el flujo de salida estándar, seguidos de la cadena de terminación de línea predeterminada; es decir, los datos van seguidos de un retorno de carro y de un salto de línea ("\r\n"). Sin embargo, la clase Console no proporciona un método correspondiente para escribir datos en el flujo de salida de error estándar, ni una propiedad para cambiar la cadena de terminación de línea de los datos escritos en ese flujo.

Este problema se puede resolver estableciendo la propiedad TextWriter.NewLine de la propiedad Out o Error en otra cadena de terminación de línea. Por ejemplo, la instrucción Console.Error.NewLine = "\r\n\r\n"; de C# establece la cadena de terminación de línea del flujo de salida de error estándar en dos secuencias de retorno de carro y salto de línea. A continuación, se puede llamar explícitamente al método WriteLine del objeto de flujo de salida de error, como en la instrucción Console.Error.WriteLine(); de C#.

Búfer de pantalla y ventana de la consola

Dos características estrechamente relacionadas de la consola son el búfer de pantalla y la ventana de la consola. En realidad, el texto se lee o escribe en flujos propiedad de la consola, aunque aparentemente se lee o escribe en un área de la que es propietaria la consola y que se denomina búfer de pantalla. El búfer de pantalla es un atributo de la consola que está organizado como una cuadrícula rectangular de filas y columnas, en la que cada intersección de la cuadrícula, o celda de carácter, puede contener un carácter. Cada carácter tiene su propio color de primer plano y cada celda de carácter tiene su propio color de fondo.

El búfer de pantalla se ve a través de una región rectangular denominada ventana de la consola. La ventana de la consola es otro atributo de la consola; no la propia consola, y es una ventana de sistema operativo. La ventana de la consola también está organizada en filas y columnas; su tamaño es menor o igual que el del búfer de pantalla y se puede mover para ver las distintas áreas del búfer de pantalla subyacente. Si el búfer de pantalla es mayor que la ventana de la consola, ésta muestra automáticamente barras de desplazamiento para poder cambiar la posición de la ventana en el área del búfer de pantalla.

Un cursor indica la posición en el búfer de pantalla donde se está leyendo o escribiendo el texto actualmente. El cursor se puede ocultar o mostrar y también es posible cambiar su alto. Cuando el cursor está visible, la posición de la ventana de la consola se mueve automáticamente de modo que el cursor siempre quede a la vista.

El origen de las coordenadas de celda de carácter en el búfer de pantalla es la esquina superior izquierda, y la posición del cursor y de la ventana de la consola se miden con respecto a dicho origen. Utilice índices de base cero para indicar las posiciones; es decir, especifique la fila superior como fila 0 y la columna situada más a la izquierda como columna 0. El valor máximo para los índices de columna y fila es Int16.MaxValue.

Funcionalidad

La clase Console contiene métodos que leen caracteres individuales o líneas enteras de la consola; también contiene varios métodos de escritura que convierten automáticamente una instancia de un tipo de valor, una matriz de caracteres o un conjunto de objetos en una cadena con o sin formato y, a continuación, escriben en la consola esa cadena que, opcionalmente, va seguida de una cadena de terminación de línea. La clase Console también incluye métodos y propiedades para obtener o establecer el tamaño del búfer de pantalla, de la ventana de la consola y del cursor, para cambiar la posición de la ventana de la consola y del cursor, para mover o borrar datos en el búfer de pantalla, para cambiar los colores de primer plano y de fondo, para cambiar el texto que se muestra en la barra de título de la consola, y para reproducir el sonido de un bip.

La clase Console también incluye miembros que admiten personalización de la apariencia de la propia ventana de la consola. Puede llamar al método SetWindowSize para cambiar el número de filas y columnas en la ventana de la consola al mismo tiempo, o puede usar las propiedades WindowWidth y WindowHeight para cambiar el número de filas y columnas independientemente unas de otras. Puede usar las propiedades ForegroundColor y BackgroundColor para controlar el color de la ventana de la consola y las propiedades CursorSize y CursorVisible para personalizar el cursor en la ventana de la consola.

En este ejemplo de código se muestra la forma de leer y escribir en los flujos de entrada y salida estándar. Tenga en cuenta que estos flujos pueden redirigirse utilizando los métodos SetIn y SetOut.


public static void Main(string[] args) {
    Console.Write("Hola ");
    Console.WriteLine("Mundo!");
    Console.WriteLine("What is your name: ");
    String name = Console.ReadLine();
    Console.Write("Buenos Dias, ");
    Console.Write(name);
    Console.WriteLine("!");
}


.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Este tipo es seguro para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft