Console.ReadLine Método

Referencia

Definición

Espacio de nombres:: System

Ensamblado:: System.Console.dll

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.dll

Source:: Console.cs

Source:: Console.cs

Source:: Console.cs

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Lee la siguiente línea de caracteres del flujo de entrada estándar.

public:
 static System::String ^ ReadLine();

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static string? ReadLine ();

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Runtime.Versioning.UnsupportedOSPlatform("android")]
public static string? ReadLine ();

public static string ReadLine ();

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member ReadLine : unit -> string

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("android")>]
static member ReadLine : unit -> string

static member ReadLine : unit -> string

Public Shared Function ReadLine () As String

Devoluciones

String

La siguiente línea de caracteres del flujo de entrada o null si no hay más líneas disponibles.

Atributos: UnsupportedOSPlatformAttribute

Excepciones

IOException

Error de E/S.

OutOfMemoryException

No hay memoria suficiente para asignar un búfer para la cadena devuelta.

ArgumentOutOfRangeException

El número de caracteres de la siguiente línea de caracteres es mayor que Int32.MaxValue.

Ejemplos

En el ejemplo siguiente se requieren dos argumentos de línea de comandos: el nombre de un archivo de texto existente y el nombre de un archivo en el que escribir la salida. Abre el archivo de texto existente y redirige la entrada estándar desde el teclado a ese archivo. También redirige la salida estándar de la consola al archivo de salida. A continuación, usa el Console.ReadLine método para leer cada línea del archivo, reemplaza cada secuencia de cuatro espacios por un carácter de tabulación y usa el Console.WriteLine método para escribir el resultado en el archivo de salida.

using namespace System;
using namespace System::IO;

int main()
{
   array<String^>^args = Environment::GetCommandLineArgs();
   const int tabSize = 4;
   String^ usageText = "Usage: INSERTTABS inputfile.txt outputfile.txt";
   StreamWriter^ writer = nullptr;
   if ( args->Length < 3 )
   {
      Console::WriteLine( usageText );
      return 1;
   }

   try
   {
      // Attempt to open output file.
      writer = gcnew StreamWriter( args[ 2 ] );
      // Redirect standard output from the console to the output file.
      Console::SetOut( writer );
      // Redirect standard input from the console to the input file.
      Console::SetIn( gcnew StreamReader( args[ 1 ] ) );
   }
   catch ( IOException^ e ) 
   {
      TextWriter^ errorWriter = Console::Error;
      errorWriter->WriteLine( e->Message );
      errorWriter->WriteLine( usageText );
      return 1;
   }

   String^ line;
   while ( (line = Console::ReadLine()) != nullptr )
   {
      String^ newLine = line->Replace( ((String^)"")->PadRight( tabSize, ' ' ), "\t" );
      Console::WriteLine( newLine );
   }

   writer->Close();
   
   // Recover the standard output stream so that a 
   // completion message can be displayed.
   StreamWriter^ standardOutput = gcnew StreamWriter( Console::OpenStandardOutput() );
   standardOutput->AutoFlush = true;
   Console::SetOut( standardOutput );
   Console::WriteLine( "INSERTTABS has completed the processing of {0}.", args[ 1 ] );
   return 0;
}

using System;
using System.IO;

public class InsertTabs
{
    private const int tabSize = 4;
    private const string usageText = "Usage: INSERTTABS inputfile.txt outputfile.txt";
    public static int Main(string[] args)
    {
        if (args.Length < 2)
        {
            Console.WriteLine(usageText);
            return 1;
        }

        try
        {
            // Attempt to open output file.
            using (var writer = new StreamWriter(args[1]))
            {
                using (var reader = new StreamReader(args[0]))
                {
                    // Redirect standard output from the console to the output file.
                    Console.SetOut(writer);
                    // Redirect standard input from the console to the input file.
                    Console.SetIn(reader);
                    string line;
                    while ((line = Console.ReadLine()) != null)
                    {
                        string newLine = line.Replace(("").PadRight(tabSize, ' '), "\t");
                        Console.WriteLine(newLine);
                    }
                }
            }
        }
        catch(IOException e)
        {
            TextWriter errorWriter = Console.Error;
            errorWriter.WriteLine(e.Message);
            errorWriter.WriteLine(usageText);
            return 1;
        }

        // Recover the standard output stream so that a
        // completion message can be displayed.
        var standardOutput = new StreamWriter(Console.OpenStandardOutput());
        standardOutput.AutoFlush = true;
        Console.SetOut(standardOutput);
        Console.WriteLine($"INSERTTABS has completed the processing of {args[0]}.");
        return 0;
    }
}

open System
open System.IO

let tabSize = 4
let usageText = "Usage: INSERTTABS inputfile.txt outputfile.txt"

[<EntryPoint>]
let main args =
    if args.Length < 2 then
        Console.WriteLine usageText
        1
    else
        try
            // Attempt to open output file.
            use reader = new StreamReader(args[0])
            use writer = new StreamWriter(args[1])
            
            // Redirect standard output from the console to the output file.
            Console.SetOut writer
            
            // Redirect standard input from the console to the input file.
            Console.SetIn reader
            
            let mutable line = Console.ReadLine()
            while line <> null do
                let newLine = line.Replace(("").PadRight(tabSize, ' '), "\t")
                Console.WriteLine newLine
                line <- Console.ReadLine()

            // Recover the standard output stream so that a
            // completion message can be displayed.
            let standardOutput = new StreamWriter(Console.OpenStandardOutput())
            standardOutput.AutoFlush <- true
            Console.SetOut standardOutput
            Console.WriteLine $"INSERTTABS has completed the processing of {args[0]}."
            0

        with :? IOException as e -> 
            let errorWriter = Console.Error
            errorWriter.WriteLine e.Message
            errorWriter.WriteLine usageText
            1

Imports System.IO

Public Module InsertTabs
    Private Const tabSize As Integer = 4
    Private Const usageText As String = "Usage: INSERTTABS inputfile.txt outputfile.txt"
   
    Public Function Main(args As String()) As Integer
        If args.Length < 2 Then
            Console.WriteLine(usageText)
            Return 1
        End If
      
        Try
            ' Attempt to open output file.
            Using writer As New StreamWriter(args(1))
                Using reader As New StreamReader(args(0))
                    ' Redirect standard output from the console to the output file.
                    Console.SetOut(writer)
                    ' Redirect standard input from the console to the input file.
                    Console.SetIn(reader)
                    Dim line As String = Console.ReadLine()
                    While line IsNot Nothing
                        Dim newLine As String = line.Replace("".PadRight(tabSize, " "c), ControlChars.Tab)
                        Console.WriteLine(newLine)
                        line = Console.ReadLine()
                    End While
                End Using
            End Using
        Catch e As IOException
            Dim errorWriter As TextWriter = Console.Error
            errorWriter.WriteLine(e.Message)
            errorWriter.WriteLine(usageText)
            Return 1
        End Try

        ' Recover the standard output stream so that a 
        ' completion message can be displayed.
        Dim standardOutput As New StreamWriter(Console.OpenStandardOutput())
        standardOutput.AutoFlush = True
        Console.SetOut(standardOutput)
        Console.WriteLine($"INSERTTABS has completed the processing of {args(0)}.")
        Return 0
    End Function 
End Module

Comentarios

El ReadLine método lee una línea del flujo de entrada estándar. (Para obtener la definición de una línea, vea el párrafo después de la lista siguiente). Esto significa que:

Si el dispositivo de entrada estándar es el teclado, el ReadLine método se bloquea hasta que el usuario presione la tecla Entrar .

Uno de los usos más comunes del método es pausar la ReadLine ejecución del programa antes de borrar la consola y mostrar nueva información en él, o bien pedir al usuario que presione la tecla Entrar antes de finalizar la aplicación. Esto se ilustra en el siguiente ejemplo:

using namespace System;

void main()
{
    Console::Clear();

    DateTime dat = DateTime::Now;

    Console::WriteLine("\nToday is {0:d} at {0:T}.", dat);
    Console::Write("\nPress any key to continue... ");
    Console::ReadLine();
}
// The example displays output like the following:
//     Today is 10/26/2015 at 12:22:22 PM.
//     
//     Press any key to continue...

using System;

public class Example
{
   public static void Main()
   {
      Console.Clear();

      DateTime dat = DateTime.Now;

      Console.WriteLine("\nToday is {0:d} at {0:T}.", dat);
      Console.Write("\nPress any key to continue... ");
      Console.ReadLine();
   }
}
// The example displays output like the following:
//     Today is 10/26/2015 at 12:22:22 PM.
//
//     Press any key to continue...

open System

Console.Clear()

let dat = DateTime.Now

printfn $"\nToday is {dat:d} at {dat:T}." 
printf "\nPress any key to continue... "
Console.ReadLine() |> ignore

// The example displays output like the following:
//     Today is 12/28/2021 at 8:23:50 PM.
//
//     Press any key to continue...

Module Example
   Public Sub Main()
      Console.Clear()

      Dim dat As Date = Date.Now

      Console.WriteLine()
      Console.WriteLine("Today is {0:d} at {0:T}.", dat)
      Console.WriteLine()
      Console.Write("Press any key to continue... ")
      Console.ReadLine()
   End Sub
End Module
' The example displays output like the following:
'     Today is 10/26/2015 at 12:22:22 PM.
'     
'     Press any key to continue...

Si se redirige la entrada estándar a un archivo, el ReadLine método lee una línea de texto de un archivo. Por ejemplo, lo siguiente es un archivo de texto denominado ReadLine1.txt:


This is the first line.
This is the second line.
This is the third line.
This is the fourth line.

En el ejemplo siguiente se usa el método para leer la ReadLine entrada que se redirige desde un archivo. La operación de lectura finaliza cuando el método devuelve null, lo que indica que no se lee ninguna línea.

using System;

public class Example
{
   public static void Main()
   {
      if (! Console.IsInputRedirected) {
         Console.WriteLine("This example requires that input be redirected from a file.");
         return;
      }

      Console.WriteLine("About to call Console.ReadLine in a loop.");
      Console.WriteLine("----");
      String s;
      int ctr = 0;
      do {
         ctr++;
         s = Console.ReadLine();
         Console.WriteLine("Line {0}: {1}", ctr, s);
      } while (s != null);
      Console.WriteLine("---");
   }
}
// The example displays the following output:
//       About to call Console.ReadLine in a loop.
//       ----
//       Line 1: This is the first line.
//       Line 2: This is the second line.
//       Line 3: This is the third line.
//       Line 4: This is the fourth line.
//       Line 5:
//       ---

open System

if not Console.IsInputRedirected then
    printfn "This example requires that input be redirected from a file."

printfn "About to call Console.ReadLine in a loop."
printfn "----"

let mutable s = ""
let mutable i = 0

while s <> null do
    i <- i + 1
    s <- Console.ReadLine()
    printfn $"Line {i}: {s}"
printfn "---"


// The example displays the following output:
//       About to call Console.ReadLine in a loop.
//       ----
//       Line 1: This is the first line.
//       Line 2: This is the second line.
//       Line 3: This is the third line.
//       Line 4: This is the fourth line.
//       Line 5:
//       ---

Module Example
   Public Sub Main()
      If Not Console.IsInputRedirected Then
         Console.WriteLine("This example requires that input be redirected from a file.")
         Exit Sub 
      End If

      Console.WriteLine("About to call Console.ReadLine in a loop.")
      Console.WriteLine("----")
      Dim s As String
      Dim ctr As Integer
      Do
         ctr += 1
         s = Console.ReadLine()
         Console.WriteLine("Line {0}: {1}", ctr, s)
      Loop While s IsNot Nothing
      Console.WriteLine("---")
   End Sub
End Module
' The example displays the following output:
'       About to call Console.ReadLine in a loop.
'       ----
'       Line 1: This is the first line.
'       Line 2: This is the second line.
'       Line 3: This is the third line.
'       Line 4: This is the fourth line.
'       Line 5:
'       ---

Después de compilar el ejemplo en un archivo ejecutable denominado ReadLine1.exe, puede ejecutarlo desde la línea de comandos para leer el contenido del archivo y mostrarlo en la consola. La sintaxis es:

ReadLine1 < ReadLine1.txt

Una línea se define como una secuencia de caracteres seguida de un retorno de carro (0x000d hexadecimal), una fuente de línea (0x000a hexadecimal) o el valor de la Environment.NewLine propiedad . La cadena devuelta no contiene los caracteres de terminación. De forma predeterminada, el método lee la entrada de un búfer de entrada de 256 caracteres. Dado que esto incluye los Environment.NewLine caracteres, el método puede leer líneas que contienen hasta 254 caracteres. Para leer líneas más largas, llame al OpenStandardInput(Int32) método .

El ReadLine método se ejecuta de forma sincrónica. Es decir, se bloquea hasta que se lee una línea o se presiona la combinación de teclado Ctrl+Z (seguida de Entrar en Windows). La In propiedad devuelve un TextReader objeto que representa el flujo de entrada estándar y que tiene un método sincrónico TextReader.ReadLine y un método asincrónico TextReader.ReadLineAsync . Sin embargo, cuando se usa como flujo de entrada estándar de la consola, se TextReader.ReadLineAsync ejecuta de forma sincrónica en lugar de de forma asincrónica y devuelve un Task<String> solo una vez completada la operación de lectura.

Si este método produce una OutOfMemoryException excepción, la posición del lector en el objeto subyacente Stream está avanzada por el número de caracteres que el método pudo leer, pero los caracteres que ya se leen en el búfer interno ReadLine se descartan. Puesto que no se puede cambiar la posición del lector en la secuencia, los caracteres ya leídos son irrecuperables y solo se puede acceder a él reinicializando .TextReader Si la posición inicial dentro de la secuencia es desconocida o la secuencia no admite la búsqueda, el subyacente Stream también debe reinicializarse. Para evitar esta situación y generar código sólido, debe usar la propiedad y el KeyAvailable método y ReadKey almacenar los caracteres de lectura en un búfer asignado previamente.

Si se presiona la combinación de teclas Ctrl+Z (seguida de Entrar en Windows) cuando el método lee la entrada de la consola, el método devuelve null. Esto permite al usuario evitar más entradas de teclado cuando se llama al ReadLine método en un bucle. Este escenario se ilustra en el ejemplo siguiente.

using namespace System;

void main()
{
   String^ line;
   Console::WriteLine("Enter one or more lines of text (press CTRL+Z to exit):");
   Console::WriteLine();
   do { 
      Console::Write("   ");
      line = Console::ReadLine();
      if (line != nullptr) 
         Console::WriteLine("      " + line);
   } while (line != nullptr);   
}
// The following displays possible output from this example:
//       Enter one or more lines of text (press CTRL+Z to exit):
//       
//          This is line #1.
//             This is line #1.
//          This is line #2
//             This is line #2
//          ^Z
//       
//       >}

using System;

public class Example
{
   public static void Main()
   {
      string line;
      Console.WriteLine("Enter one or more lines of text (press CTRL+Z to exit):");
      Console.WriteLine();
      do {
         Console.Write("   ");
         line = Console.ReadLine();
         if (line != null)
            Console.WriteLine("      " + line);
      } while (line != null);
   }
}
// The following displays possible output from this example:
//       Enter one or more lines of text (press CTRL+Z to exit):
//
//          This is line #1.
//             This is line #1.
//          This is line #2
//             This is line #2
//          ^Z
//
//       >

open System

printfn "Enter one or more lines of text (press CTRL+Z to exit):\n"

let mutable line = ""

while line <> null do
    printf "   "
    line <- Console.ReadLine()
    if line <> null then
        printfn $"      {line}"


// The following displays possible output from this example:
//       Enter one or more lines of text (press CTRL+Z to exit):
//
//          This is line #1.
//             This is line #1.
//          This is line #2
//             This is line #2
//          ^Z
//
//       >

Module Example
   Public Sub Main()
      Dim line As String
      Console.WriteLine("Enter one or more lines of text (press CTRL+Z to exit):")
      Console.WriteLine()
      Do 
         Console.Write("   ")
         line = Console.ReadLine()
         If line IsNot Nothing Then Console.WriteLine("      " + line)
      Loop While line IsNot Nothing   
   End Sub
End Module
' The following displays possible output from this example:
'       Enter one or more lines of text (press CTRL+Z to exit):
'       
'          This is line #1.
'             This is line #1.
'          This is line #2
'             This is line #2
'          ^Z
'       
'       >

Se aplica a

Compartir a través de