Leer en inglés

Compartir a través de

Console.WriteLine Método

  • Referencia

Definición

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

Escribe los datos especificados, seguidos del terminador de línea actual, en el flujo de salida estándar.

Sobrecargas

WriteLine(String, Object, Object)

Escribe la representación de texto de los objetos especificados, seguido del terminador de línea actual, en el flujo de salida estándar mediante la información de formato especificada.
WriteLine(String)

Escribe el valor de cadena especificado, seguido del terminador de línea actual, en el flujo de salida estándar.
WriteLine(Char[], Int32, Int32)

Escribe la subbarray especificada de caracteres Unicode, seguido del terminador de línea actual, en el flujo de salida estándar.
WriteLine(String, ReadOnlySpan<Object>)

Escribe la representación de texto del intervalo de objetos especificado, seguido del terminador de línea actual, en el flujo de salida estándar mediante la información de formato especificada.
WriteLine(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 mediante la información de formato especificada.
WriteLine(String, Object)

Escribe la representación de texto del objeto especificado, seguido del terminador de línea actual, en el flujo de salida estándar mediante la información de formato especificada.
WriteLine(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.
WriteLine(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.
WriteLine(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.
WriteLine(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.
WriteLine(Int64)

Escribe la representación de texto del valor entero con signo de 64 bits especificado, seguido del terminador de línea actual, en el flujo de salida estándar.
WriteLine(Int32)

Escribe la representación de texto del valor entero con signo de 32 bits especificado, seguido del terminador de línea actual, en el flujo de salida estándar.
WriteLine(Decimal)

Escribe la representación de texto del valor de Decimal especificado, seguido del terminador de línea actual, en el flujo de salida estándar.
WriteLine(Char[])

Escribe la matriz especificada de caracteres Unicode, seguido del terminador de línea actual, en el flujo de salida estándar.
WriteLine(Char)

Escribe el carácter Unicode especificado, seguido del terminador de línea actual, el valor en el flujo de salida estándar.
WriteLine(Boolean)

Escribe la representación de texto del valor booleano especificado, seguido del terminador de línea actual, en el flujo de salida estándar.
WriteLine()

Escribe el terminador de línea actual en el flujo de salida estándar.
WriteLine(String, Object, Object, Object)

Escribe la representación de texto de los objetos especificados, seguido del terminador de línea actual, en el flujo de salida estándar mediante la información de formato especificada.
WriteLine(Object)

Escribe la representación de texto del objeto especificado, seguido del terminador de línea actual, en el flujo de salida estándar.
WriteLine(String, Object, Object, Object, Object)

Escribe la representación de texto de los objetos especificados y la lista de parámetros de longitud variable, seguido del terminador de línea actual, en el flujo de salida estándar mediante la información de formato especificada.

Comentarios

El terminador de línea predeterminado es una cadena cuyo valor es un retorno de carro seguido de una fuente de línea ("\r\n" en C#, o vbCrLf en Visual Basic). Puede cambiar el terminador de línea estableciendo la propiedad TextWriter.NewLine de la propiedad Out en otra cadena.

WriteLine(String, Object, Object)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Escribe la representación de texto de los objetos especificados, seguido del terminador de línea actual, en el flujo de salida estándar mediante la información de formato especificada.

C# 
public static void WriteLine (string format, object? arg0, object? arg1);
C# 
public static void WriteLine (string format, object arg0, object arg1);

Parámetros

format
String

Cadena de formato compuesto.

arg0
Object

Primer objeto que se va a escribir mediante format.

arg1
Object

Segundo objeto que se va a escribir mediante format.

Excepciones

IOException

Error de E/S.

ArgumentNullException

format es null.

FormatException

La especificación de formato en format no es válida.

Ejemplos

En el ejemplo siguiente se muestran los especificadores de formato estándar para números, fechas y enumeraciones.

C# 
// This code example demonstrates the Console.WriteLine() method.
// Formatting for this example uses the "en-US" culture.

using System;
class Sample
{
    enum Color {Yellow = 1, Blue, Green};
    static DateTime thisDate = DateTime.Now;

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

        // Format a negative integer or floating-point number in various ways.
        Console.WriteLine("Standard Numeric Format Specifiers");
        Console.WriteLine(
            "(C) Currency: . . . . . . . . {0:C}\n" +
            "(D) Decimal:. . . . . . . . . {0:D}\n" +
            "(E) Scientific: . . . . . . . {1:E}\n" +
            "(F) Fixed point:. . . . . . . {1:F}\n" +
            "(G) General:. . . . . . . . . {0:G}\n" +
            "    (default):. . . . . . . . {0} (default = 'G')\n" +
            "(N) Number: . . . . . . . . . {0:N}\n" +
            "(P) Percent:. . . . . . . . . {1:P}\n" +
            "(R) Round-trip: . . . . . . . {1:R}\n" +
            "(X) Hexadecimal:. . . . . . . {0:X}\n",
            -123, -123.45f);

        // Format the current date in various ways.
        Console.WriteLine("Standard DateTime Format Specifiers");
        Console.WriteLine(
            "(d) Short date: . . . . . . . {0:d}\n" +
            "(D) Long date:. . . . . . . . {0:D}\n" +
            "(t) Short time: . . . . . . . {0:t}\n" +
            "(T) Long time:. . . . . . . . {0:T}\n" +
            "(f) Full date/short time: . . {0:f}\n" +
            "(F) Full date/long time:. . . {0:F}\n" +
            "(g) General date/short time:. {0:g}\n" +
            "(G) General date/long time: . {0:G}\n" +
            "    (default):. . . . . . . . {0} (default = 'G')\n" +
            "(M) Month:. . . . . . . . . . {0:M}\n" +
            "(R) RFC1123:. . . . . . . . . {0:R}\n" +
            "(s) Sortable: . . . . . . . . {0:s}\n" +
            "(u) Universal sortable: . . . {0:u} (invariant)\n" +
            "(U) Universal full date/time: {0:U}\n" +
            "(Y) Year: . . . . . . . . . . {0:Y}\n",
            thisDate);

        // Format a Color enumeration value in various ways.
        Console.WriteLine("Standard Enumeration Format Specifiers");
        Console.WriteLine(
            "(G) General:. . . . . . . . . {0:G}\n" +
            "    (default):. . . . . . . . {0} (default = 'G')\n" +
            "(F) Flags:. . . . . . . . . . {0:F} (flags or integer)\n" +
            "(D) Decimal number: . . . . . {0:D}\n" +
            "(X) Hexadecimal:. . . . . . . {0:X}\n",
            Color.Green);
    }
}
/*
This code example produces the following results:

Standard Numeric Format Specifiers
(C) Currency: . . . . . . . . ($123.00)
(D) Decimal:. . . . . . . . . -123
(E) Scientific: . . . . . . . -1.234500E+002
(F) Fixed point:. . . . . . . -123.45
(G) General:. . . . . . . . . -123
    (default):. . . . . . . . -123 (default = 'G')
(N) Number: . . . . . . . . . -123.00
(P) Percent:. . . . . . . . . -12,345.00 %
(R) Round-trip: . . . . . . . -123.45
(X) Hexadecimal:. . . . . . . FFFFFF85

Standard DateTime Format Specifiers
(d) Short date: . . . . . . . 6/26/2004
(D) Long date:. . . . . . . . Saturday, June 26, 2004
(t) Short time: . . . . . . . 8:11 PM
(T) Long time:. . . . . . . . 8:11:04 PM
(f) Full date/short time: . . Saturday, June 26, 2004 8:11 PM
(F) Full date/long time:. . . Saturday, June 26, 2004 8:11:04 PM
(g) General date/short time:. 6/26/2004 8:11 PM
(G) General date/long time: . 6/26/2004 8:11:04 PM
    (default):. . . . . . . . 6/26/2004 8:11:04 PM (default = 'G')
(M) Month:. . . . . . . . . . June 26
(R) RFC1123:. . . . . . . . . Sat, 26 Jun 2004 20:11:04 GMT
(s) Sortable: . . . . . . . . 2004-06-26T20:11:04
(u) Universal sortable: . . . 2004-06-26 20:11:04Z (invariant)
(U) Universal full date/time: Sunday, June 27, 2004 3:11:04 AM
(Y) Year: . . . . . . . . . . June, 2004

Standard Enumeration Format Specifiers
(G) General:. . . . . . . . . Green
    (default):. . . . . . . . Green (default = 'G')
(F) Flags:. . . . . . . . . . Green (flags or integer)
(D) Decimal number: . . . . . 3
(X) Hexadecimal:. . . . . . . 00000003

*/

El ejemplo siguiente es una calculadora de propinas que calcula una propina de 18% y usa el método WriteLine para mostrar la cantidad del cargo original, la cantidad de la propina y el importe total. El ejemplo es una aplicación de consola que requiere que el usuario proporcione la cantidad del cargo original como parámetro de línea de comandos.

C# 
using System;

public class TipCalculator
{
    private const double tipRate = 0.18;
    public static void Main(string[] args)
    {
        double billTotal;
        if (args.Length == 0 || ! Double.TryParse(args[0], out billTotal))
        {
            Console.WriteLine("usage: TIPCALC total");
            return;
        }
        double tip = billTotal * tipRate;
        Console.WriteLine();
        Console.WriteLine($"Bill total:\t{billTotal,8:c}");
        Console.WriteLine($"Tip total/rate:\t{tip,8:c} ({tipRate:p1})");
        Console.WriteLine(("").PadRight(24, '-'));
        Console.WriteLine($"Grand total:\t{billTotal + tip,8:c}");
    }
}

/*
>tipcalc 52.23

Bill total:       $52.23
Tip total/rate:    $9.40 (18.0 %)
------------------------
Grand total:      $61.63
*/

Comentarios

Este método usa la característica de formato compuesto de .NET para convertir el valor de un objeto en su representación de texto e insertar esa representación en una cadena. La cadena resultante se escribe en el flujo de salida.

El parámetro format consta de cero o más ejecuciones de texto entremezcladas con cero o más marcadores de posición indexados, denominados elementos de formato, que corresponden a un objeto de la lista de parámetros de este método. El proceso de formato reemplaza cada elemento de formato por la representación de texto del valor del objeto correspondiente.

La sintaxis de un elemento de formato es {índice[,alineación][:formatString]}, que especifica un índice obligatorio, la longitud opcional y la alineación del texto con formato y una cadena opcional de caracteres de especificador de formato que rigen cómo se da formato al valor del objeto correspondiente.

.NET proporciona compatibilidad amplia con formato, que se describe con más detalle en los temas de formato siguientes.

Para obtener más información sobre el terminador de línea, vea la sección Comentarios del método WriteLine que no toma parámetros.

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(String)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Escribe el valor de cadena especificado, seguido del terminador de línea actual, en el flujo de salida estándar.

C# 
public static void WriteLine (string? value);
C# 
public static void WriteLine (string value);

Parámetros

value
String

Valor que se va a escribir.

Excepciones

IOException

Error de E/S.

Ejemplos

En el ejemplo se cambia el terminador de línea de su valor predeterminado de "\r\n" o vbCrLf a "\r\n\r\n" o vbCrLf + vbCrLf. A continuación, llama a los métodos WriteLine() y WriteLine(String) para mostrar la salida en la consola.

C# 
string[] lines = { "This is the first line.",
                   "This is the second line." };
// Output the lines using the default newline sequence.
Console.WriteLine("With the default new line characters:");
Console.WriteLine();
foreach (string line in lines)
   Console.WriteLine(line);

Console.WriteLine();

// Redefine the newline characters to double space.
Console.Out.NewLine = "\r\n\r\n";
// Output the lines using the new newline sequence.
Console.WriteLine("With redefined new line characters:");
Console.WriteLine();
foreach (string line in lines)
   Console.WriteLine(line);

// The example displays the following output:
//       With the default new line characters:
//
//       This is the first line.
//       This is the second line.
//
//       With redefined new line characters:
//
//
//
//       This is the first line.
//
//       This is the second line.

Comentarios

Si el valor es null, solo se escribe el terminador de línea en el flujo de salida estándar.

Para obtener más información sobre el terminador de línea, vea la sección Comentarios del método WriteLine().

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(Char[], Int32, Int32)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Escribe la subbarray especificada de caracteres Unicode, seguido del terminador de línea actual, en el flujo de salida estándar.

C# 
public static void WriteLine (char[] buffer, int index, int count);

Parámetros

buffer
Char[]

Matriz de caracteres Unicode.

index
Int32

Posición inicial de buffer.

count
Int32

Número de caracteres que se van a escribir.

Excepciones

ArgumentNullException

buffer es null.

ArgumentOutOfRangeException

index o count es menor que cero.

ArgumentException

index más count especificar una posición que no está dentro de buffer.

IOException

Error de E/S.

Comentarios

Este método escribe count caracteres a partir de la posición index de buffer en el flujo de salida estándar.

Para obtener más información sobre el terminador de línea, vea la sección Comentarios del método WriteLine que no toma parámetros.

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(String, ReadOnlySpan<Object>)

Escribe la representación de texto del intervalo de objetos especificado, seguido del terminador de línea actual, en el flujo de salida estándar mediante la información de formato especificada.

C# 
public static void WriteLine (string format, scoped ReadOnlySpan<object?> arg);

Parámetros

format
String

Cadena de formato compuesto.

arg
ReadOnlySpan<Object>

Intervalo de objetos que se van a escribir mediante formato.

Se aplica a

.NET 9
Producto Versiones
.NET 9

WriteLine(String, Object[])

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

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 mediante la información de formato especificada.

C# 
public static void WriteLine (string format, params object?[]? arg);
C# 
public static void WriteLine (string format, params object[] arg);

Parámetros

format
String

Cadena de formato compuesto.

arg
Object[]

Matriz de objetos que se van a escribir mediante format.

Excepciones

IOException

Error de E/S.

ArgumentNullException

format o arg es null.

FormatException

La especificación de formato en format no es válida.

Ejemplos

En el ejemplo siguiente se muestran los especificadores de formato estándar para números, fechas y enumeraciones.

C# 
// This code example demonstrates the Console.WriteLine() method.
// Formatting for this example uses the "en-US" culture.

using System;
class Sample
{
    enum Color {Yellow = 1, Blue, Green};
    static DateTime thisDate = DateTime.Now;

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

        // Format a negative integer or floating-point number in various ways.
        Console.WriteLine("Standard Numeric Format Specifiers");
        Console.WriteLine(
            "(C) Currency: . . . . . . . . {0:C}\n" +
            "(D) Decimal:. . . . . . . . . {0:D}\n" +
            "(E) Scientific: . . . . . . . {1:E}\n" +
            "(F) Fixed point:. . . . . . . {1:F}\n" +
            "(G) General:. . . . . . . . . {0:G}\n" +
            "    (default):. . . . . . . . {0} (default = 'G')\n" +
            "(N) Number: . . . . . . . . . {0:N}\n" +
            "(P) Percent:. . . . . . . . . {1:P}\n" +
            "(R) Round-trip: . . . . . . . {1:R}\n" +
            "(X) Hexadecimal:. . . . . . . {0:X}\n",
            -123, -123.45f);

        // Format the current date in various ways.
        Console.WriteLine("Standard DateTime Format Specifiers");
        Console.WriteLine(
            "(d) Short date: . . . . . . . {0:d}\n" +
            "(D) Long date:. . . . . . . . {0:D}\n" +
            "(t) Short time: . . . . . . . {0:t}\n" +
            "(T) Long time:. . . . . . . . {0:T}\n" +
            "(f) Full date/short time: . . {0:f}\n" +
            "(F) Full date/long time:. . . {0:F}\n" +
            "(g) General date/short time:. {0:g}\n" +
            "(G) General date/long time: . {0:G}\n" +
            "    (default):. . . . . . . . {0} (default = 'G')\n" +
            "(M) Month:. . . . . . . . . . {0:M}\n" +
            "(R) RFC1123:. . . . . . . . . {0:R}\n" +
            "(s) Sortable: . . . . . . . . {0:s}\n" +
            "(u) Universal sortable: . . . {0:u} (invariant)\n" +
            "(U) Universal full date/time: {0:U}\n" +
            "(Y) Year: . . . . . . . . . . {0:Y}\n",
            thisDate);

        // Format a Color enumeration value in various ways.
        Console.WriteLine("Standard Enumeration Format Specifiers");
        Console.WriteLine(
            "(G) General:. . . . . . . . . {0:G}\n" +
            "    (default):. . . . . . . . {0} (default = 'G')\n" +
            "(F) Flags:. . . . . . . . . . {0:F} (flags or integer)\n" +
            "(D) Decimal number: . . . . . {0:D}\n" +
            "(X) Hexadecimal:. . . . . . . {0:X}\n",
            Color.Green);
    }
}
/*
This code example produces the following results:

Standard Numeric Format Specifiers
(C) Currency: . . . . . . . . ($123.00)
(D) Decimal:. . . . . . . . . -123
(E) Scientific: . . . . . . . -1.234500E+002
(F) Fixed point:. . . . . . . -123.45
(G) General:. . . . . . . . . -123
    (default):. . . . . . . . -123 (default = 'G')
(N) Number: . . . . . . . . . -123.00
(P) Percent:. . . . . . . . . -12,345.00 %
(R) Round-trip: . . . . . . . -123.45
(X) Hexadecimal:. . . . . . . FFFFFF85

Standard DateTime Format Specifiers
(d) Short date: . . . . . . . 6/26/2004
(D) Long date:. . . . . . . . Saturday, June 26, 2004
(t) Short time: . . . . . . . 8:11 PM
(T) Long time:. . . . . . . . 8:11:04 PM
(f) Full date/short time: . . Saturday, June 26, 2004 8:11 PM
(F) Full date/long time:. . . Saturday, June 26, 2004 8:11:04 PM
(g) General date/short time:. 6/26/2004 8:11 PM
(G) General date/long time: . 6/26/2004 8:11:04 PM
    (default):. . . . . . . . 6/26/2004 8:11:04 PM (default = 'G')
(M) Month:. . . . . . . . . . June 26
(R) RFC1123:. . . . . . . . . Sat, 26 Jun 2004 20:11:04 GMT
(s) Sortable: . . . . . . . . 2004-06-26T20:11:04
(u) Universal sortable: . . . 2004-06-26 20:11:04Z (invariant)
(U) Universal full date/time: Sunday, June 27, 2004 3:11:04 AM
(Y) Year: . . . . . . . . . . June, 2004

Standard Enumeration Format Specifiers
(G) General:. . . . . . . . . Green
    (default):. . . . . . . . Green (default = 'G')
(F) Flags:. . . . . . . . . . Green (flags or integer)
(D) Decimal number: . . . . . 3
(X) Hexadecimal:. . . . . . . 00000003

*/

El ejemplo siguiente es una calculadora de propinas que calcula una propina de 18% y usa el método WriteLine para mostrar la cantidad del cargo original, la cantidad de la propina y el importe total. El ejemplo es una aplicación de consola que requiere que el usuario proporcione la cantidad del cargo original como parámetro de línea de comandos.

C# 
using System;

public class TipCalculator
{
    private const double tipRate = 0.18;
    public static void Main(string[] args)
    {
        double billTotal;
        if (args.Length == 0 || ! Double.TryParse(args[0], out billTotal))
        {
            Console.WriteLine("usage: TIPCALC total");
            return;
        }
        double tip = billTotal * tipRate;
        Console.WriteLine();
        Console.WriteLine($"Bill total:\t{billTotal,8:c}");
        Console.WriteLine($"Tip total/rate:\t{tip,8:c} ({tipRate:p1})");
        Console.WriteLine(("").PadRight(24, '-'));
        Console.WriteLine($"Grand total:\t{billTotal + tip,8:c}");
    }
}

/*
>tipcalc 52.23

Bill total:       $52.23
Tip total/rate:    $9.40 (18.0 %)
------------------------
Grand total:      $61.63
*/

Comentarios

Este método usa la característica de formato compuesto de .NET para convertir el valor de un objeto en su representación de texto e insertar esa representación en una cadena. La cadena resultante se escribe en el flujo de salida.

El parámetro format consta de cero o más ejecuciones de texto entremezcladas con cero o más marcadores de posición indexados, denominados elementos de formato, que corresponden a un objeto de la lista de parámetros de este método. El proceso de formato reemplaza cada elemento de formato por la representación de texto del valor del objeto correspondiente.

La sintaxis de un elemento de formato es {índice[,alineación][:formatString]}, que especifica un índice obligatorio, la longitud opcional y la alineación del texto con formato y una cadena opcional de caracteres de especificador de formato que rigen cómo se da formato al valor del objeto correspondiente.

.NET proporciona compatibilidad amplia con formato, que se describe con más detalle en los temas de formato siguientes.

Para obtener más información sobre el terminador de línea, vea la sección Comentarios del método WriteLine que no toma parámetros.

Notas a los autores de las llamadas

El código de C++ no llama a este método. El compilador de C++ resuelve las llamadas a System.Console.WriteLine que incluyen una cadena y una lista de cuatro o más parámetros de objeto como una llamada a WriteLine(String, Object, Object, Object, Object). Resuelve las llamadas a System.Console.WriteLine que incluyen una cadena y una matriz de objetos como una llamada a WriteLine(String, Object).

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(String, Object)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Escribe la representación de texto del objeto especificado, seguido del terminador de línea actual, en el flujo de salida estándar mediante la información de formato especificada.

C# 
public static void WriteLine (string format, object? arg0);
C# 
public static void WriteLine (string format, object arg0);

Parámetros

format
String

Cadena de formato compuesto.

arg0
Object

Objeto que se va a escribir mediante format.

Excepciones

IOException

Error de E/S.

ArgumentNullException

format es null.

FormatException

La especificación de formato en format no es válida.

Ejemplos

En el ejemplo siguiente se llama al método WriteLine(String, Object) para mostrar cinco valores de Boolean generados aleatoriamente.

C# 
Random rnd = new Random();
// Generate five random Boolean values.
for (int ctr = 1; ctr <= 5; ctr++) {
   bool bln = rnd.Next(0, 2) == 1;
   Console.WriteLine($"True or False: {bln}");
}

// The example displays an output similar to the following:
//       True or False: False
//       True or False: True
//       True or False: False
//       True or False: False
//       True or False: True

En el ejemplo siguiente se llama al método WriteLine(String, Object) para mostrar la fecha actual. Tenga en cuenta que el elemento de formato del argumento format usa el cadena de formato de fecha y hora estándar para mostrar la fecha en el formato de fecha larga de la referencia cultural actual.

C# 
using System;

public class Example
{
   public static void Main()
   {
      Console.WriteLine("Today's date: {0:D}", DateTime.Now);
   }
}
// The example displays output like the following:
//       Today's date: Monday, April 1, 2019

Comentarios

Este método usa la característica de formato compuesto de .NET para convertir el valor de un objeto en su representación de texto e insertar esa representación en una cadena. La cadena resultante se escribe en el flujo de salida.

El parámetro format consta de cero o más ejecuciones de texto entremezcladas con cero o más marcadores de posición indexados, denominados elementos de formato, que corresponden a un objeto de la lista de parámetros de este método. El proceso de formato reemplaza cada elemento de formato por la representación de texto del valor del objeto correspondiente.

La sintaxis de un elemento de formato es {índice[,alineación][:formatString]}, que especifica un índice obligatorio, la longitud opcional y la alineación del texto con formato y una cadena opcional de caracteres de especificador de formato que rigen cómo se da formato al valor del objeto correspondiente.

.NET proporciona compatibilidad amplia con formato, que se describe con más detalle en los temas de formato siguientes.

Para obtener más información sobre el terminador de línea, vea la sección Comentarios del método WriteLine que no toma parámetros.

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(UInt64)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Importante

Esta API no es conforme a CLS.

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.

C# 
[System.CLSCompliant(false)]
public static void WriteLine (ulong value);

Parámetros

value
UInt64

Valor que se va a escribir.

Atributos
CLSCompliantAttribute

Excepciones

IOException

Error de E/S.

Ejemplos

El ejemplo siguiente es una calculadora de propinas que calcula una propina de 18% y usa el método WriteLine para mostrar la cantidad del cargo original, la cantidad de la propina y el importe total. El ejemplo es una aplicación de consola que requiere que el usuario proporcione la cantidad del cargo original como parámetro de línea de comandos.

C# 
using System;

public class TipCalculator
{
    private const double tipRate = 0.18;
    public static void Main(string[] args)
    {
        double billTotal;
        if (args.Length == 0 || ! Double.TryParse(args[0], out billTotal))
        {
            Console.WriteLine("usage: TIPCALC total");
            return;
        }
        double tip = billTotal * tipRate;
        Console.WriteLine();
        Console.WriteLine($"Bill total:\t{billTotal,8:c}");
        Console.WriteLine($"Tip total/rate:\t{tip,8:c} ({tipRate:p1})");
        Console.WriteLine(("").PadRight(24, '-'));
        Console.WriteLine($"Grand total:\t{billTotal + tip,8:c}");
    }
}

/*
>tipcalc 52.23

Bill total:       $52.23
Tip total/rate:    $9.40 (18.0 %)
------------------------
Grand total:      $61.63
*/

Comentarios

La representación de texto de value se genera llamando al método UInt64.ToString.

Para obtener más información sobre el terminador de línea, vea la sección Comentarios del método WriteLine que no toma parámetros.

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(UInt32)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Importante

Esta API no es conforme a CLS.

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.

C# 
[System.CLSCompliant(false)]
public static void WriteLine (uint value);

Parámetros

value
UInt32

Valor que se va a escribir.

Atributos
CLSCompliantAttribute

Excepciones

IOException

Error de E/S.

Ejemplos

El ejemplo siguiente es una calculadora de propinas que calcula una propina de 18% y usa el método WriteLine para mostrar la cantidad del cargo original, la cantidad de la propina y el importe total. El ejemplo es una aplicación de consola que requiere que el usuario proporcione la cantidad del cargo original como parámetro de línea de comandos.

C# 
using System;

public class TipCalculator
{
    private const double tipRate = 0.18;
    public static void Main(string[] args)
    {
        double billTotal;
        if (args.Length == 0 || ! Double.TryParse(args[0], out billTotal))
        {
            Console.WriteLine("usage: TIPCALC total");
            return;
        }
        double tip = billTotal * tipRate;
        Console.WriteLine();
        Console.WriteLine($"Bill total:\t{billTotal,8:c}");
        Console.WriteLine($"Tip total/rate:\t{tip,8:c} ({tipRate:p1})");
        Console.WriteLine(("").PadRight(24, '-'));
        Console.WriteLine($"Grand total:\t{billTotal + tip,8:c}");
    }
}

/*
>tipcalc 52.23

Bill total:       $52.23
Tip total/rate:    $9.40 (18.0 %)
------------------------
Grand total:      $61.63
*/

Comentarios

La representación de texto de value se genera llamando al método UInt32.ToString.

Para obtener más información sobre el terminador de línea, vea la sección Comentarios del método WriteLine que no toma parámetros.

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(Single)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

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.

C# 
public static void WriteLine (float value);

Parámetros

value
Single

Valor que se va a escribir.

Excepciones

IOException

Error de E/S.

Ejemplos

El ejemplo siguiente es una calculadora de propinas que calcula una propina de 18% y usa el método WriteLine para mostrar la cantidad del cargo original, la cantidad de la propina y el importe total. El ejemplo es una aplicación de consola que requiere que el usuario proporcione la cantidad del cargo original como parámetro de línea de comandos.

C# 
using System;

public class TipCalculator
{
    private const double tipRate = 0.18;
    public static void Main(string[] args)
    {
        double billTotal;
        if (args.Length == 0 || ! Double.TryParse(args[0], out billTotal))
        {
            Console.WriteLine("usage: TIPCALC total");
            return;
        }
        double tip = billTotal * tipRate;
        Console.WriteLine();
        Console.WriteLine($"Bill total:\t{billTotal,8:c}");
        Console.WriteLine($"Tip total/rate:\t{tip,8:c} ({tipRate:p1})");
        Console.WriteLine(("").PadRight(24, '-'));
        Console.WriteLine($"Grand total:\t{billTotal + tip,8:c}");
    }
}

/*
>tipcalc 52.23

Bill total:       $52.23
Tip total/rate:    $9.40 (18.0 %)
------------------------
Grand total:      $61.63
*/

Comentarios

La representación de texto de value se genera llamando al método Single.ToString.

Para obtener más información sobre el terminador de línea, vea la sección Comentarios del método WriteLine que no toma parámetros.

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(Double)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

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.

C# 
public static void WriteLine (double value);

Parámetros

value
Double

Valor que se va a escribir.

Excepciones

IOException

Error de E/S.

Ejemplos

El ejemplo siguiente es una calculadora de propinas que calcula una propina de 18% y usa el método WriteLine para mostrar la cantidad del cargo original, la cantidad de la propina y el importe total. El ejemplo es una aplicación de consola que requiere que el usuario proporcione la cantidad del cargo original como parámetro de línea de comandos.

C# 
using System;

public class TipCalculator
{
    private const double tipRate = 0.18;
    public static void Main(string[] args)
    {
        double billTotal;
        if (args.Length == 0 || ! Double.TryParse(args[0], out billTotal))
        {
            Console.WriteLine("usage: TIPCALC total");
            return;
        }
        double tip = billTotal * tipRate;
        Console.WriteLine();
        Console.WriteLine($"Bill total:\t{billTotal,8:c}");
        Console.WriteLine($"Tip total/rate:\t{tip,8:c} ({tipRate:p1})");
        Console.WriteLine(("").PadRight(24, '-'));
        Console.WriteLine($"Grand total:\t{billTotal + tip,8:c}");
    }
}

/*
>tipcalc 52.23

Bill total:       $52.23
Tip total/rate:    $9.40 (18.0 %)
------------------------
Grand total:      $61.63
*/

Comentarios

La representación de texto de value se genera llamando al método Double.ToString.

Para obtener más información sobre el terminador de línea, vea la sección Comentarios del método WriteLine que no toma parámetros.

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(Int64)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Escribe la representación de texto del valor entero con signo de 64 bits especificado, seguido del terminador de línea actual, en el flujo de salida estándar.

C# 
public static void WriteLine (long value);

Parámetros

value
Int64

Valor que se va a escribir.

Excepciones

IOException

Error de E/S.

Ejemplos

El ejemplo siguiente es una calculadora de propinas que calcula una propina de 18% y usa el método WriteLine para mostrar la cantidad del cargo original, la cantidad de la propina y el importe total. El ejemplo es una aplicación de consola que requiere que el usuario proporcione la cantidad del cargo original como parámetro de línea de comandos.

C# 
using System;

public class TipCalculator
{
    private const double tipRate = 0.18;
    public static void Main(string[] args)
    {
        double billTotal;
        if (args.Length == 0 || ! Double.TryParse(args[0], out billTotal))
        {
            Console.WriteLine("usage: TIPCALC total");
            return;
        }
        double tip = billTotal * tipRate;
        Console.WriteLine();
        Console.WriteLine($"Bill total:\t{billTotal,8:c}");
        Console.WriteLine($"Tip total/rate:\t{tip,8:c} ({tipRate:p1})");
        Console.WriteLine(("").PadRight(24, '-'));
        Console.WriteLine($"Grand total:\t{billTotal + tip,8:c}");
    }
}

/*
>tipcalc 52.23

Bill total:       $52.23
Tip total/rate:    $9.40 (18.0 %)
------------------------
Grand total:      $61.63
*/

Comentarios

La representación de texto de value se genera llamando al método Int64.ToString.

Para obtener más información sobre el terminador de línea, vea la sección Comentarios del método WriteLine que no toma parámetros.

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(Int32)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Escribe la representación de texto del valor entero con signo de 32 bits especificado, seguido del terminador de línea actual, en el flujo de salida estándar.

C# 
public static void WriteLine (int value);

Parámetros

value
Int32

Valor que se va a escribir.

Excepciones

IOException

Error de E/S.

Ejemplos

El ejemplo siguiente es una calculadora de propinas que calcula una propina de 18% y usa el método WriteLine para mostrar la cantidad del cargo original, la cantidad de la propina y el importe total. El ejemplo es una aplicación de consola que requiere que el usuario proporcione la cantidad del cargo original como parámetro de línea de comandos.

C# 
using System;

public class TipCalculator
{
    private const double tipRate = 0.18;
    public static void Main(string[] args)
    {
        double billTotal;
        if (args.Length == 0 || ! Double.TryParse(args[0], out billTotal))
        {
            Console.WriteLine("usage: TIPCALC total");
            return;
        }
        double tip = billTotal * tipRate;
        Console.WriteLine();
        Console.WriteLine($"Bill total:\t{billTotal,8:c}");
        Console.WriteLine($"Tip total/rate:\t{tip,8:c} ({tipRate:p1})");
        Console.WriteLine(("").PadRight(24, '-'));
        Console.WriteLine($"Grand total:\t{billTotal + tip,8:c}");
    }
}

/*
>tipcalc 52.23

Bill total:       $52.23
Tip total/rate:    $9.40 (18.0 %)
------------------------
Grand total:      $61.63
*/

Comentarios

La representación de texto de value se genera llamando al método Int32.ToString.

Para obtener más información sobre el terminador de línea, vea la sección Comentarios del método WriteLine que no toma parámetros.

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(Decimal)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Escribe la representación de texto del valor de Decimal especificado, seguido del terminador de línea actual, en el flujo de salida estándar.

C# 
public static void WriteLine (decimal value);

Parámetros

value
Decimal

Valor que se va a escribir.

Excepciones

IOException

Error de E/S.

Ejemplos

El ejemplo siguiente es una calculadora de propinas que calcula una propina de 18% y usa el método WriteLine para mostrar la cantidad del cargo original, la cantidad de la propina y el importe total. El ejemplo es una aplicación de consola que requiere que el usuario proporcione la cantidad del cargo original como parámetro de línea de comandos.

C# 
using System;

public class TipCalculator
{
    private const double tipRate = 0.18;
    public static void Main(string[] args)
    {
        double billTotal;
        if (args.Length == 0 || ! Double.TryParse(args[0], out billTotal))
        {
            Console.WriteLine("usage: TIPCALC total");
            return;
        }
        double tip = billTotal * tipRate;
        Console.WriteLine();
        Console.WriteLine($"Bill total:\t{billTotal,8:c}");
        Console.WriteLine($"Tip total/rate:\t{tip,8:c} ({tipRate:p1})");
        Console.WriteLine(("").PadRight(24, '-'));
        Console.WriteLine($"Grand total:\t{billTotal + tip,8:c}");
    }
}

/*
>tipcalc 52.23

Bill total:       $52.23
Tip total/rate:    $9.40 (18.0 %)
------------------------
Grand total:      $61.63
*/

Comentarios

La representación de texto de value se genera llamando al método Decimal.ToString.

Para obtener más información sobre el terminador de línea, vea la sección Comentarios del método WriteLine que no toma parámetros.

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(Char[])

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Escribe la matriz especificada de caracteres Unicode, seguido del terminador de línea actual, en el flujo de salida estándar.

C# 
public static void WriteLine (char[]? buffer);
C# 
public static void WriteLine (char[] buffer);

Parámetros

buffer
Char[]

Matriz de caracteres Unicode.

Excepciones

IOException

Error de E/S.

Comentarios

Para obtener más información sobre el terminador de línea, vea la sección Comentarios del método WriteLine que no toma parámetros.

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(Char)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Escribe el carácter Unicode especificado, seguido del terminador de línea actual, el valor en el flujo de salida estándar.

C# 
public static void WriteLine (char value);

Parámetros

value
Char

Valor que se va a escribir.

Excepciones

IOException

Error de E/S.

Ejemplos

El ejemplo siguiente es una calculadora de propinas que calcula una propina de 18% y usa el método WriteLine para mostrar la cantidad del cargo original, la cantidad de la propina y el importe total. El ejemplo es una aplicación de consola que requiere que el usuario proporcione la cantidad del cargo original como parámetro de línea de comandos.

C# 
using System;

public class TipCalculator
{
    private const double tipRate = 0.18;
    public static void Main(string[] args)
    {
        double billTotal;
        if (args.Length == 0 || ! Double.TryParse(args[0], out billTotal))
        {
            Console.WriteLine("usage: TIPCALC total");
            return;
        }
        double tip = billTotal * tipRate;
        Console.WriteLine();
        Console.WriteLine($"Bill total:\t{billTotal,8:c}");
        Console.WriteLine($"Tip total/rate:\t{tip,8:c} ({tipRate:p1})");
        Console.WriteLine(("").PadRight(24, '-'));
        Console.WriteLine($"Grand total:\t{billTotal + tip,8:c}");
    }
}

/*
>tipcalc 52.23

Bill total:       $52.23
Tip total/rate:    $9.40 (18.0 %)
------------------------
Grand total:      $61.63
*/

Comentarios

Para obtener más información sobre el terminador de línea, vea la sección Comentarios del método WriteLine que no toma parámetros.

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(Boolean)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Escribe la representación de texto del valor booleano especificado, seguido del terminador de línea actual, en el flujo de salida estándar.

C# 
public static void WriteLine (bool value);

Parámetros

value
Boolean

Valor que se va a escribir.

Excepciones

IOException

Error de E/S.

Ejemplos

En el ejemplo siguiente se generan diez enteros aleatorios y se usa el método Console.WriteLine(Boolean) para indicar si son incluso.

C# 
// Assign 10 random integers to an array.
Random rnd = new Random();
int[] numbers = new int[10];
for (int ctr = 0; ctr <= numbers.GetUpperBound(0); ctr++)
   numbers[ctr] = rnd.Next();

// Determine whether the numbers are even or odd.
foreach (var number in numbers) {
   bool even = (number % 2 == 0);
   Console.WriteLine("Is {0} even:", number);
   Console.WriteLine(even);
   Console.WriteLine();
}

Comentarios

La representación de texto de value se genera llamando al método Boolean.ToString.

Para obtener más información sobre el terminador de línea, vea la sección Comentarios del método WriteLine que no toma parámetros.

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine()

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Escribe el terminador de línea actual en el flujo de salida estándar.

C# 
public static void WriteLine ();

Excepciones

IOException

Error de E/S.

Ejemplos

En el ejemplo se cambia el terminador de línea de su valor predeterminado de "\r\n" o vbCrLf a "\r\n\r\n" o vbCrLf + vbCrLf. A continuación, llama a los métodos WriteLine() y WriteLine(String) para mostrar la salida en la consola.

C# 
string[] lines = { "This is the first line.",
                   "This is the second line." };
// Output the lines using the default newline sequence.
Console.WriteLine("With the default new line characters:");
Console.WriteLine();
foreach (string line in lines)
   Console.WriteLine(line);

Console.WriteLine();

// Redefine the newline characters to double space.
Console.Out.NewLine = "\r\n\r\n";
// Output the lines using the new newline sequence.
Console.WriteLine("With redefined new line characters:");
Console.WriteLine();
foreach (string line in lines)
   Console.WriteLine(line);

// The example displays the following output:
//       With the default new line characters:
//
//       This is the first line.
//       This is the second line.
//
//       With redefined new line characters:
//
//
//
//       This is the first line.
//
//       This is the second line.

Comentarios

El terminador de línea predeterminado es una cadena cuyo valor es un retorno de carro seguido de una fuente de línea ("\r\n" en C#, o vbCrLf en Visual Basic). Puede cambiar el terminador de línea estableciendo la propiedad TextWriter.NewLine de la propiedad Out en otra cadena. En el ejemplo se proporciona una ilustración.

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(String, Object, Object, Object)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Escribe la representación de texto de los objetos especificados, seguido del terminador de línea actual, en el flujo de salida estándar mediante la información de formato especificada.

C# 
public static void WriteLine (string format, object? arg0, object? arg1, object? arg2);
C# 
public static void WriteLine (string format, object arg0, object arg1, object arg2);

Parámetros

format
String

Cadena de formato compuesto.

arg0
Object

Primer objeto que se va a escribir mediante format.

arg1
Object

Segundo objeto que se va a escribir mediante format.

arg2
Object

Tercer objeto que se va a escribir mediante format.

Excepciones

IOException

Error de E/S.

ArgumentNullException

format es null.

FormatException

La especificación de formato en format no es válida.

Ejemplos

En el ejemplo siguiente se muestran los especificadores de formato estándar para números, fechas y enumeraciones.

C# 
// This code example demonstrates the Console.WriteLine() method.
// Formatting for this example uses the "en-US" culture.

using System;
class Sample
{
    enum Color {Yellow = 1, Blue, Green};
    static DateTime thisDate = DateTime.Now;

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

        // Format a negative integer or floating-point number in various ways.
        Console.WriteLine("Standard Numeric Format Specifiers");
        Console.WriteLine(
            "(C) Currency: . . . . . . . . {0:C}\n" +
            "(D) Decimal:. . . . . . . . . {0:D}\n" +
            "(E) Scientific: . . . . . . . {1:E}\n" +
            "(F) Fixed point:. . . . . . . {1:F}\n" +
            "(G) General:. . . . . . . . . {0:G}\n" +
            "    (default):. . . . . . . . {0} (default = 'G')\n" +
            "(N) Number: . . . . . . . . . {0:N}\n" +
            "(P) Percent:. . . . . . . . . {1:P}\n" +
            "(R) Round-trip: . . . . . . . {1:R}\n" +
            "(X) Hexadecimal:. . . . . . . {0:X}\n",
            -123, -123.45f);

        // Format the current date in various ways.
        Console.WriteLine("Standard DateTime Format Specifiers");
        Console.WriteLine(
            "(d) Short date: . . . . . . . {0:d}\n" +
            "(D) Long date:. . . . . . . . {0:D}\n" +
            "(t) Short time: . . . . . . . {0:t}\n" +
            "(T) Long time:. . . . . . . . {0:T}\n" +
            "(f) Full date/short time: . . {0:f}\n" +
            "(F) Full date/long time:. . . {0:F}\n" +
            "(g) General date/short time:. {0:g}\n" +
            "(G) General date/long time: . {0:G}\n" +
            "    (default):. . . . . . . . {0} (default = 'G')\n" +
            "(M) Month:. . . . . . . . . . {0:M}\n" +
            "(R) RFC1123:. . . . . . . . . {0:R}\n" +
            "(s) Sortable: . . . . . . . . {0:s}\n" +
            "(u) Universal sortable: . . . {0:u} (invariant)\n" +
            "(U) Universal full date/time: {0:U}\n" +
            "(Y) Year: . . . . . . . . . . {0:Y}\n",
            thisDate);

        // Format a Color enumeration value in various ways.
        Console.WriteLine("Standard Enumeration Format Specifiers");
        Console.WriteLine(
            "(G) General:. . . . . . . . . {0:G}\n" +
            "    (default):. . . . . . . . {0} (default = 'G')\n" +
            "(F) Flags:. . . . . . . . . . {0:F} (flags or integer)\n" +
            "(D) Decimal number: . . . . . {0:D}\n" +
            "(X) Hexadecimal:. . . . . . . {0:X}\n",
            Color.Green);
    }
}
/*
This code example produces the following results:

Standard Numeric Format Specifiers
(C) Currency: . . . . . . . . ($123.00)
(D) Decimal:. . . . . . . . . -123
(E) Scientific: . . . . . . . -1.234500E+002
(F) Fixed point:. . . . . . . -123.45
(G) General:. . . . . . . . . -123
    (default):. . . . . . . . -123 (default = 'G')
(N) Number: . . . . . . . . . -123.00
(P) Percent:. . . . . . . . . -12,345.00 %
(R) Round-trip: . . . . . . . -123.45
(X) Hexadecimal:. . . . . . . FFFFFF85

Standard DateTime Format Specifiers
(d) Short date: . . . . . . . 6/26/2004
(D) Long date:. . . . . . . . Saturday, June 26, 2004
(t) Short time: . . . . . . . 8:11 PM
(T) Long time:. . . . . . . . 8:11:04 PM
(f) Full date/short time: . . Saturday, June 26, 2004 8:11 PM
(F) Full date/long time:. . . Saturday, June 26, 2004 8:11:04 PM
(g) General date/short time:. 6/26/2004 8:11 PM
(G) General date/long time: . 6/26/2004 8:11:04 PM
    (default):. . . . . . . . 6/26/2004 8:11:04 PM (default = 'G')
(M) Month:. . . . . . . . . . June 26
(R) RFC1123:. . . . . . . . . Sat, 26 Jun 2004 20:11:04 GMT
(s) Sortable: . . . . . . . . 2004-06-26T20:11:04
(u) Universal sortable: . . . 2004-06-26 20:11:04Z (invariant)
(U) Universal full date/time: Sunday, June 27, 2004 3:11:04 AM
(Y) Year: . . . . . . . . . . June, 2004

Standard Enumeration Format Specifiers
(G) General:. . . . . . . . . Green
    (default):. . . . . . . . Green (default = 'G')
(F) Flags:. . . . . . . . . . Green (flags or integer)
(D) Decimal number: . . . . . 3
(X) Hexadecimal:. . . . . . . 00000003

*/

El ejemplo siguiente es una calculadora de propinas que calcula una propina de 18% y usa el método WriteLine para mostrar la cantidad del cargo original, la cantidad de la propina y el importe total. El ejemplo es una aplicación de consola que requiere que el usuario proporcione la cantidad del cargo original como parámetro de línea de comandos.

C# 
using System;

public class TipCalculator
{
    private const double tipRate = 0.18;
    public static void Main(string[] args)
    {
        double billTotal;
        if (args.Length == 0 || ! Double.TryParse(args[0], out billTotal))
        {
            Console.WriteLine("usage: TIPCALC total");
            return;
        }
        double tip = billTotal * tipRate;
        Console.WriteLine();
        Console.WriteLine($"Bill total:\t{billTotal,8:c}");
        Console.WriteLine($"Tip total/rate:\t{tip,8:c} ({tipRate:p1})");
        Console.WriteLine(("").PadRight(24, '-'));
        Console.WriteLine($"Grand total:\t{billTotal + tip,8:c}");
    }
}

/*
>tipcalc 52.23

Bill total:       $52.23
Tip total/rate:    $9.40 (18.0 %)
------------------------
Grand total:      $61.63
*/

Comentarios

Este método usa la característica de formato compuesto de .NET para convertir el valor de un objeto en su representación de texto e insertar esa representación en una cadena. La cadena resultante se escribe en el flujo de salida.

El parámetro format consta de cero o más ejecuciones de texto entremezcladas con cero o más marcadores de posición indexados, denominados elementos de formato, que corresponden a un objeto de la lista de parámetros de este método. El proceso de formato reemplaza cada elemento de formato por la representación de texto del valor del objeto correspondiente.

La sintaxis de un elemento de formato es {índice[,alineación][:formatString]}, que especifica un índice obligatorio, la longitud opcional y la alineación del texto con formato y una cadena opcional de caracteres de especificador de formato que rigen cómo se da formato al valor del objeto correspondiente.

.NET proporciona compatibilidad amplia con formato, que se describe con más detalle en los temas de formato siguientes.

Para obtener más información sobre el terminador de línea, vea la sección Comentarios del método WriteLine que no toma parámetros.

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(Object)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Escribe la representación de texto del objeto especificado, seguido del terminador de línea actual, en el flujo de salida estándar.

C# 
public static void WriteLine (object? value);
C# 
public static void WriteLine (object value);

Parámetros

value
Object

Valor que se va a escribir.

Excepciones

IOException

Error de E/S.

Ejemplos

En el ejemplo siguiente se usa el método WriteLine(Object) para mostrar cada valor de una matriz de objetos en la consola.

C# 
Object[] values = { true, 12.632, 17908, "stringValue",
                           'a', 16907.32m };
foreach (var value in values)
   Console.WriteLine(value);

// The example displays the following output:
//    True
//    12.632
//    17908
//    stringValue
//    a
//    16907.32

Comentarios

Si value es null, solo se escribe el terminador de línea. De lo contrario, se llama al método ToString de value para generar su representación de cadena y la cadena resultante se escribe en el flujo de salida estándar.

Para obtener más información sobre el terminador de línea, vea la sección Comentarios del método WriteLine que no toma parámetros.

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(String, Object, Object, Object, Object)

Importante

Esta API no es conforme a CLS.

Escribe la representación de texto de los objetos especificados y la lista de parámetros de longitud variable, seguido del terminador de línea actual, en el flujo de salida estándar mediante la información de formato especificada.

C# 
[System.CLSCompliant(false)]
public static void WriteLine (string format, object arg0, object arg1, object arg2, object arg3);

Parámetros

format
String

Cadena de formato compuesto.

arg0
Object

Primer objeto que se va a escribir mediante format.

arg1
Object

Segundo objeto que se va a escribir mediante format.

arg2
Object

Tercer objeto que se va a escribir mediante format.

arg3
Object

Cuarto objeto que se va a escribir mediante format.

Atributos
CLSCompliantAttribute

Excepciones

IOException

Error de E/S.

ArgumentNullException

format es null.

FormatException

La especificación de formato en format no es válida.

Ejemplos

En el ejemplo siguiente se muestra el uso de argumentos de variable con el método WriteLine(String, Object, Object, Object, Object). Se llama al método con una cadena de formato compuesto y cinco elementos de formato.

C++ 
using namespace System;

int CountLetters(String^ value);
int CountWhitespace(String^ value);

void main()
{
   String^ value = "This is a test string.";
   
   
   Console::WriteLine("The string '{0}' consists of:" +
                      "{4}{1} characters{4}{2} letters{4}" +
                      "{3} white-space characters", 
                      value, value->Length, CountLetters(value), 
                      CountWhitespace(value), Environment::NewLine);
}

int CountLetters(String^ value)
{
   int nLetters = 0;
   for each (Char ch in value) {
      if (Char::IsLetter(ch))
         nLetters++;
   }
   return nLetters;
}

int CountWhitespace(String^ value)
{
   int nWhitespace = 0;
   for each (Char ch in value) {
      if (Char::IsWhiteSpace(ch))
         nWhitespace++;
   }
   return nWhitespace;
}
// The example displays the following output:
//    The string 'This is a test string.' consists of:
//    22 characters
//    17 letters
//    4 white-space characters

Comentarios

Nota

Esta API no es compatible con CLS. La alternativa conforme a CLS es Console.WriteLine(String, Object[]). Los compiladores de C# y Visual Basic resuelven automáticamente una llamada a este método como una llamada a Console.WriteLine(String, Object[]).

Este método usa la característica de formato compuesto de .NET para convertir el valor de un objeto en su representación de texto e insertar esa representación en una cadena. La cadena resultante se escribe en el flujo de salida.

El parámetro format consta de cero o más ejecuciones de texto entremezcladas con cero o más marcadores de posición indexados, denominados elementos de formato, que corresponden a un objeto de la lista de parámetros de este método. El proceso de formato reemplaza cada elemento de formato por la representación de texto del valor del objeto correspondiente.

La sintaxis de un elemento de formato es {índice[,alineación][:formatString]}, que especifica un índice obligatorio, la longitud opcional y la alineación del texto con formato y una cadena opcional de caracteres de especificador de formato que rigen cómo se da formato al valor del objeto correspondiente.

.NET proporciona compatibilidad amplia con formato, que se describe con más detalle en los temas de formato siguientes.

Para obtener más información sobre el terminador de línea, vea la sección Comentarios del método WriteLine que no toma parámetros.

Notas a los autores de las llamadas

Este método está marcado con la palabra clave vararg, lo que significa que admite un número variable de parámetros. Se puede llamar al método desde Visual C++, pero no se puede llamar desde código de C# o Visual Basic. Los compiladores de C# y Visual Basic resuelven llamadas a WriteLine(String, Object, Object, Object, Object) como llamadas a WriteLine(String, Object[]).

Consulte también

Se aplica a

.NET Framework 4.8.1 y otras versiones
Producto Versiones
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1