Ler em inglês

Compartilhar via

Console.WriteLine Método

  • Referência

Definição

Namespace:
System
Assembly:
System.Console.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Grava os dados especificados, seguidos pelo terminador de linha atual, no fluxo de saída padrão.

Sobrecargas

WriteLine(String, Object, Object)

Grava a representação de texto dos objetos especificados, seguido pelo terminador de linha atual, no fluxo de saída padrão usando as informações de formato especificadas.
WriteLine(String)

Grava o valor de cadeia de caracteres especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão.
WriteLine(Char[], Int32, Int32)

Grava a subarray especificada de caracteres Unicode, seguida pelo terminador de linha atual, no fluxo de saída padrão.
WriteLine(String, ReadOnlySpan<Object>)

Grava a representação de texto do intervalo de objetos especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão usando as informações de formato especificadas.
WriteLine(String, Object[])

Grava a representação de texto da matriz de objetos especificada, seguida pelo terminador de linha atual, no fluxo de saída padrão usando as informações de formato especificadas.
WriteLine(String, Object)

Grava a representação de texto do objeto especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão usando as informações de formato especificadas.
WriteLine(UInt64)

Grava a representação de texto do valor inteiro sem sinal de 64 bits especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão.
WriteLine(UInt32)

Grava a representação de texto do valor inteiro sem sinal de 32 bits especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão.
WriteLine(Single)

Grava a representação de texto do valor de ponto flutuante de precisão única especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão.
WriteLine(Double)

Grava a representação de texto do valor de ponto flutuante de precisão dupla especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão.
WriteLine(Int64)

Grava a representação de texto do valor inteiro com sinal de 64 bits especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão.
WriteLine(Int32)

Grava a representação de texto do valor inteiro com sinal de 32 bits especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão.
WriteLine(Decimal)

Grava a representação de texto do valor Decimal especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão.
WriteLine(Char[])

Grava a matriz especificada de caracteres Unicode, seguida pelo terminador de linha atual, no fluxo de saída padrão.
WriteLine(Char)

Grava o caractere Unicode especificado, seguido pelo terminador de linha atual, valor no fluxo de saída padrão.
WriteLine(Boolean)

Grava a representação de texto do valor booliano especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão.
WriteLine()

Grava o terminador de linha atual no fluxo de saída padrão.
WriteLine(String, Object, Object, Object)

Grava a representação de texto dos objetos especificados, seguido pelo terminador de linha atual, no fluxo de saída padrão usando as informações de formato especificadas.
WriteLine(Object)

Grava a representação de texto do objeto especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão.
WriteLine(String, Object, Object, Object, Object)

Grava a representação de texto dos objetos especificados e da lista de parâmetros de comprimento variável, seguido pelo terminador de linha atual, no fluxo de saída padrão usando as informações de formato especificadas.

Comentários

O terminador de linha padrão é uma cadeia de caracteres cujo valor é um retorno de carro seguido por um feed de linha ("\r\n" em C#ou vbCrLf no Visual Basic). Você pode alterar o terminador de linha definindo a propriedade TextWriter.NewLine da propriedade Out para outra cadeia de caracteres.

WriteLine(String, Object, Object)

Origem:
Console.cs
Origem:
Console.cs
Origem:
Console.cs

Grava a representação de texto dos objetos especificados, seguido pelo terminador de linha atual, no fluxo de saída padrão usando as informações de formato especificadas.

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

Uma cadeia de caracteres de formato composto.

arg0
Object

O primeiro objeto a ser gravado usando format.

arg1
Object

O segundo objeto a ser gravado usando format.

Exceções

IOException

Ocorreu um erro de E/S.

ArgumentNullException

format é null.

FormatException

A especificação de formato em format é inválida.

Exemplos

O exemplo a seguir demonstra os especificadores de formatação padrão para números, datas e enumerações.

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

*/

O exemplo a seguir é uma calculadora de gorjetas que calcula uma dica de 18% e usa o método WriteLine para exibir a quantidade da cobrança original, a quantidade da gorjeta e a quantidade total. O exemplo é um aplicativo de console que exige que o usuário forneça a quantidade da cobrança original como um parâmetro de linha de comando.

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
*/

Comentários

Esse método usa o recurso de formatação composta do .NET para converter o valor de um objeto em sua representação de texto e inserir essa representação em uma cadeia de caracteres. A cadeia de caracteres resultante é gravada no fluxo de saída.

O parâmetro format consiste em zero ou mais execuções de texto intermixado com zero ou mais espaços reservados indexados, chamados itens de formato, que correspondem a um objeto na lista de parâmetros desse método. O processo de formatação substitui cada item de formato pela representação de texto do valor do objeto correspondente.

A sintaxe de um item de formato é {índice[,alinhamento][:formatString]}, que especifica um índice obrigatório, o comprimento opcional e o alinhamento do texto formatado e uma cadeia opcional de caracteres especificadores de formato que regem como o valor do objeto correspondente é formatado.

O .NET fornece amplo suporte à formatação, que é descrito com mais detalhes nos tópicos de formatação a seguir.

Para obter mais informações sobre o terminador de linha, consulte a seção Comentários do método WriteLine que não usa parâmetros.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.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)

Origem:
Console.cs
Origem:
Console.cs
Origem:
Console.cs

Grava o valor de cadeia de caracteres especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão.

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

Parâmetros

value
String

O valor a ser gravado.

Exceções

IOException

Ocorreu um erro de E/S.

Exemplos

O exemplo altera o terminador de linha de seu valor padrão de "\r\n" ou vbCrLf para "\r\n\r\n" ou vbCrLf + vbCrLf. Em seguida, ele chama os métodos WriteLine() e WriteLine(String) para exibir a saída para o console.

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.

Comentários

Se o valor for null, somente o terminador de linha será gravado no fluxo de saída padrão.

Para obter mais informações sobre o terminador de linha, consulte a seção Comentários do método WriteLine().

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.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)

Origem:
Console.cs
Origem:
Console.cs
Origem:
Console.cs

Grava a subarray especificada de caracteres Unicode, seguida pelo terminador de linha atual, no fluxo de saída padrão.

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

Parâmetros

buffer
Char[]

Uma matriz de caracteres Unicode.

index
Int32

A posição inicial em buffer.

count
Int32

O número de caracteres a serem gravados.

Exceções

ArgumentNullException

buffer é null.

ArgumentOutOfRangeException

index ou count é menor que zero.

ArgumentException

index mais count especificar uma posição que não esteja dentro de buffer.

IOException

Ocorreu um erro de E/S.

Comentários

Esse método grava count caracteres começando na posição index de buffer no fluxo de saída padrão.

Para obter mais informações sobre o terminador de linha, consulte a seção Comentários do método WriteLine que não usa parâmetros.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.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>)

Grava a representação de texto do intervalo de objetos especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão usando as informações de formato especificadas.

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

Parâmetros

format
String

Uma cadeia de caracteres de formato composto.

arg
ReadOnlySpan<Object>

Um intervalo de objetos a serem gravados usando o formato.

Aplica-se a

.NET 9
Produto Versões
.NET 9

WriteLine(String, Object[])

Origem:
Console.cs
Origem:
Console.cs
Origem:
Console.cs

Grava a representação de texto da matriz de objetos especificada, seguida pelo terminador de linha atual, no fluxo de saída padrão usando as informações de formato especificadas.

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

Parâmetros

format
String

Uma cadeia de caracteres de formato composto.

arg
Object[]

Uma matriz de objetos a serem gravados usando format.

Exceções

IOException

Ocorreu um erro de E/S.

ArgumentNullException

format ou arg é null.

FormatException

A especificação de formato em format é inválida.

Exemplos

O exemplo a seguir demonstra os especificadores de formatação padrão para números, datas e enumerações.

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

*/

O exemplo a seguir é uma calculadora de gorjetas que calcula uma dica de 18% e usa o método WriteLine para exibir a quantidade da cobrança original, a quantidade da gorjeta e a quantidade total. O exemplo é um aplicativo de console que exige que o usuário forneça a quantidade da cobrança original como um parâmetro de linha de comando.

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
*/

Comentários

Esse método usa o recurso de formatação composta do .NET para converter o valor de um objeto em sua representação de texto e inserir essa representação em uma cadeia de caracteres. A cadeia de caracteres resultante é gravada no fluxo de saída.

O parâmetro format consiste em zero ou mais execuções de texto intermixado com zero ou mais espaços reservados indexados, chamados itens de formato, que correspondem a um objeto na lista de parâmetros desse método. O processo de formatação substitui cada item de formato pela representação de texto do valor do objeto correspondente.

A sintaxe de um item de formato é {índice[,alinhamento][:formatString]}, que especifica um índice obrigatório, o comprimento opcional e o alinhamento do texto formatado e uma cadeia opcional de caracteres especificadores de formato que regem como o valor do objeto correspondente é formatado.

O .NET fornece amplo suporte à formatação, que é descrito com mais detalhes nos tópicos de formatação a seguir.

Para obter mais informações sobre o terminador de linha, consulte a seção Comentários do método WriteLine que não usa parâmetros.

Notas aos Chamadores

Esse método não é chamado pelo código C++. O compilador C++ resolve chamadas para System.Console.WriteLine que incluem uma cadeia de caracteres e uma lista de quatro ou mais parâmetros de objeto como uma chamada para WriteLine(String, Object, Object, Object, Object). Ele resolve chamadas para System.Console.WriteLine que incluem uma cadeia de caracteres e uma matriz de objetos como uma chamada para WriteLine(String, Object).

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.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)

Origem:
Console.cs
Origem:
Console.cs
Origem:
Console.cs

Grava a representação de texto do objeto especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão usando as informações de formato especificadas.

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

Parâmetros

format
String

Uma cadeia de caracteres de formato composto.

arg0
Object

Um objeto a ser gravado usando format.

Exceções

IOException

Ocorreu um erro de E/S.

ArgumentNullException

format é null.

FormatException

A especificação de formato em format é inválida.

Exemplos

O exemplo a seguir chama o método WriteLine(String, Object) para exibir cinco valores de Boolean gerados 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

O exemplo a seguir chama o método WriteLine(String, Object) para exibir a data atual. Observe que o item de formato no argumento format usa a cadeia de caracteres de formato de data e hora padrão "D" para exibir a data no formato de data longa da cultura atual.

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

Comentários

Esse método usa o recurso de formatação composta do .NET para converter o valor de um objeto em sua representação de texto e inserir essa representação em uma cadeia de caracteres. A cadeia de caracteres resultante é gravada no fluxo de saída.

O parâmetro format consiste em zero ou mais execuções de texto intermixado com zero ou mais espaços reservados indexados, chamados itens de formato, que correspondem a um objeto na lista de parâmetros desse método. O processo de formatação substitui cada item de formato pela representação de texto do valor do objeto correspondente.

A sintaxe de um item de formato é {índice[,alinhamento][:formatString]}, que especifica um índice obrigatório, o comprimento opcional e o alinhamento do texto formatado e uma cadeia opcional de caracteres especificadores de formato que regem como o valor do objeto correspondente é formatado.

O .NET fornece amplo suporte à formatação, que é descrito com mais detalhes nos tópicos de formatação a seguir.

Para obter mais informações sobre o terminador de linha, consulte a seção Comentários do método WriteLine que não usa parâmetros.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.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)

Origem:
Console.cs
Origem:
Console.cs
Origem:
Console.cs

Importante

Esta API não está em conformidade com CLS.

Grava a representação de texto do valor inteiro sem sinal de 64 bits especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão.

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

Parâmetros

value
UInt64

O valor a ser gravado.

Atributos
CLSCompliantAttribute

Exceções

IOException

Ocorreu um erro de E/S.

Exemplos

O exemplo a seguir é uma calculadora de gorjetas que calcula uma dica de 18% e usa o método WriteLine para exibir a quantidade da cobrança original, a quantidade da gorjeta e a quantidade total. O exemplo é um aplicativo de console que exige que o usuário forneça a quantidade da cobrança original como um parâmetro de linha de comando.

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
*/

Comentários

A representação de texto de value é produzida chamando o método UInt64.ToString.

Para obter mais informações sobre o terminador de linha, consulte a seção Comentários do método WriteLine que não usa parâmetros.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.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)

Origem:
Console.cs
Origem:
Console.cs
Origem:
Console.cs

Importante

Esta API não está em conformidade com CLS.

Grava a representação de texto do valor inteiro sem sinal de 32 bits especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão.

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

Parâmetros

value
UInt32

O valor a ser gravado.

Atributos
CLSCompliantAttribute

Exceções

IOException

Ocorreu um erro de E/S.

Exemplos

O exemplo a seguir é uma calculadora de gorjetas que calcula uma dica de 18% e usa o método WriteLine para exibir a quantidade da cobrança original, a quantidade da gorjeta e a quantidade total. O exemplo é um aplicativo de console que exige que o usuário forneça a quantidade da cobrança original como um parâmetro de linha de comando.

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
*/

Comentários

A representação de texto de value é produzida chamando o método UInt32.ToString.

Para obter mais informações sobre o terminador de linha, consulte a seção Comentários do método WriteLine que não usa parâmetros.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.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)

Origem:
Console.cs
Origem:
Console.cs
Origem:
Console.cs

Grava a representação de texto do valor de ponto flutuante de precisão única especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão.

C# 
public static void WriteLine (float value);

Parâmetros

value
Single

O valor a ser gravado.

Exceções

IOException

Ocorreu um erro de E/S.

Exemplos

O exemplo a seguir é uma calculadora de gorjetas que calcula uma dica de 18% e usa o método WriteLine para exibir a quantidade da cobrança original, a quantidade da gorjeta e a quantidade total. O exemplo é um aplicativo de console que exige que o usuário forneça a quantidade da cobrança original como um parâmetro de linha de comando.

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
*/

Comentários

A representação de texto de value é produzida chamando o método Single.ToString.

Para obter mais informações sobre o terminador de linha, consulte a seção Comentários do método WriteLine que não usa parâmetros.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.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)

Origem:
Console.cs
Origem:
Console.cs
Origem:
Console.cs

Grava a representação de texto do valor de ponto flutuante de precisão dupla especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão.

C# 
public static void WriteLine (double value);

Parâmetros

value
Double

O valor a ser gravado.

Exceções

IOException

Ocorreu um erro de E/S.

Exemplos

O exemplo a seguir é uma calculadora de gorjetas que calcula uma dica de 18% e usa o método WriteLine para exibir a quantidade da cobrança original, a quantidade da gorjeta e a quantidade total. O exemplo é um aplicativo de console que exige que o usuário forneça a quantidade da cobrança original como um parâmetro de linha de comando.

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
*/

Comentários

A representação de texto de value é produzida chamando o método Double.ToString.

Para obter mais informações sobre o terminador de linha, consulte a seção Comentários do método WriteLine que não usa parâmetros.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.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)

Origem:
Console.cs
Origem:
Console.cs
Origem:
Console.cs

Grava a representação de texto do valor inteiro com sinal de 64 bits especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão.

C# 
public static void WriteLine (long value);

Parâmetros

value
Int64

O valor a ser gravado.

Exceções

IOException

Ocorreu um erro de E/S.

Exemplos

O exemplo a seguir é uma calculadora de gorjetas que calcula uma dica de 18% e usa o método WriteLine para exibir a quantidade da cobrança original, a quantidade da gorjeta e a quantidade total. O exemplo é um aplicativo de console que exige que o usuário forneça a quantidade da cobrança original como um parâmetro de linha de comando.

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
*/

Comentários

A representação de texto de value é produzida chamando o método Int64.ToString.

Para obter mais informações sobre o terminador de linha, consulte a seção Comentários do método WriteLine que não usa parâmetros.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.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)

Origem:
Console.cs
Origem:
Console.cs
Origem:
Console.cs

Grava a representação de texto do valor inteiro com sinal de 32 bits especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão.

C# 
public static void WriteLine (int value);

Parâmetros

value
Int32

O valor a ser gravado.

Exceções

IOException

Ocorreu um erro de E/S.

Exemplos

O exemplo a seguir é uma calculadora de gorjetas que calcula uma dica de 18% e usa o método WriteLine para exibir a quantidade da cobrança original, a quantidade da gorjeta e a quantidade total. O exemplo é um aplicativo de console que exige que o usuário forneça a quantidade da cobrança original como um parâmetro de linha de comando.

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
*/

Comentários

A representação de texto de value é produzida chamando o método Int32.ToString.

Para obter mais informações sobre o terminador de linha, consulte a seção Comentários do método WriteLine que não usa parâmetros.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.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)

Origem:
Console.cs
Origem:
Console.cs
Origem:
Console.cs

Grava a representação de texto do valor Decimal especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão.

C# 
public static void WriteLine (decimal value);

Parâmetros

value
Decimal

O valor a ser gravado.

Exceções

IOException

Ocorreu um erro de E/S.

Exemplos

O exemplo a seguir é uma calculadora de gorjetas que calcula uma dica de 18% e usa o método WriteLine para exibir a quantidade da cobrança original, a quantidade da gorjeta e a quantidade total. O exemplo é um aplicativo de console que exige que o usuário forneça a quantidade da cobrança original como um parâmetro de linha de comando.

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
*/

Comentários

A representação de texto de value é produzida chamando o método Decimal.ToString.

Para obter mais informações sobre o terminador de linha, consulte a seção Comentários do método WriteLine que não usa parâmetros.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.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[])

Origem:
Console.cs
Origem:
Console.cs
Origem:
Console.cs

Grava a matriz especificada de caracteres Unicode, seguida pelo terminador de linha atual, no fluxo de saída padrão.

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

Parâmetros

buffer
Char[]

Uma matriz de caracteres Unicode.

Exceções

IOException

Ocorreu um erro de E/S.

Comentários

Para obter mais informações sobre o terminador de linha, consulte a seção Comentários do método WriteLine que não usa parâmetros.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.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)

Origem:
Console.cs
Origem:
Console.cs
Origem:
Console.cs

Grava o caractere Unicode especificado, seguido pelo terminador de linha atual, valor no fluxo de saída padrão.

C# 
public static void WriteLine (char value);

Parâmetros

value
Char

O valor a ser gravado.

Exceções

IOException

Ocorreu um erro de E/S.

Exemplos

O exemplo a seguir é uma calculadora de gorjetas que calcula uma dica de 18% e usa o método WriteLine para exibir a quantidade da cobrança original, a quantidade da gorjeta e a quantidade total. O exemplo é um aplicativo de console que exige que o usuário forneça a quantidade da cobrança original como um parâmetro de linha de comando.

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
*/

Comentários

Para obter mais informações sobre o terminador de linha, consulte a seção Comentários do método WriteLine que não usa parâmetros.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.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)

Origem:
Console.cs
Origem:
Console.cs
Origem:
Console.cs

Grava a representação de texto do valor booliano especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão.

C# 
public static void WriteLine (bool value);

Parâmetros

value
Boolean

O valor a ser gravado.

Exceções

IOException

Ocorreu um erro de E/S.

Exemplos

O exemplo a seguir gera dez inteiros aleatórios e usa o método Console.WriteLine(Boolean) para indicar se eles estão quites.

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();
}

Comentários

A representação de texto de value é produzida chamando o método Boolean.ToString.

Para obter mais informações sobre o terminador de linha, consulte a seção Comentários do método WriteLine que não usa parâmetros.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.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()

Origem:
Console.cs
Origem:
Console.cs
Origem:
Console.cs

Grava o terminador de linha atual no fluxo de saída padrão.

C# 
public static void WriteLine ();

Exceções

IOException

Ocorreu um erro de E/S.

Exemplos

O exemplo altera o terminador de linha de seu valor padrão de "\r\n" ou vbCrLf para "\r\n\r\n" ou vbCrLf + vbCrLf. Em seguida, ele chama os métodos WriteLine() e WriteLine(String) para exibir a saída para o console.

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.

Comentários

O terminador de linha padrão é uma cadeia de caracteres cujo valor é um retorno de carro seguido por um feed de linha ("\r\n" em C#ou vbCrLf no Visual Basic). Você pode alterar o terminador de linha definindo a propriedade TextWriter.NewLine da propriedade Out para outra cadeia de caracteres. O exemplo fornece uma ilustração.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.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)

Origem:
Console.cs
Origem:
Console.cs
Origem:
Console.cs

Grava a representação de texto dos objetos especificados, seguido pelo terminador de linha atual, no fluxo de saída padrão usando as informações de formato especificadas.

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

Uma cadeia de caracteres de formato composto.

arg0
Object

O primeiro objeto a ser gravado usando format.

arg1
Object

O segundo objeto a ser gravado usando format.

arg2
Object

O terceiro objeto a ser gravado usando format.

Exceções

IOException

Ocorreu um erro de E/S.

ArgumentNullException

format é null.

FormatException

A especificação de formato em format é inválida.

Exemplos

O exemplo a seguir demonstra os especificadores de formatação padrão para números, datas e enumerações.

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

*/

O exemplo a seguir é uma calculadora de gorjetas que calcula uma dica de 18% e usa o método WriteLine para exibir a quantidade da cobrança original, a quantidade da gorjeta e a quantidade total. O exemplo é um aplicativo de console que exige que o usuário forneça a quantidade da cobrança original como um parâmetro de linha de comando.

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
*/

Comentários

Esse método usa o recurso de formatação composta do .NET para converter o valor de um objeto em sua representação de texto e inserir essa representação em uma cadeia de caracteres. A cadeia de caracteres resultante é gravada no fluxo de saída.

O parâmetro format consiste em zero ou mais execuções de texto intermixado com zero ou mais espaços reservados indexados, chamados itens de formato, que correspondem a um objeto na lista de parâmetros desse método. O processo de formatação substitui cada item de formato pela representação de texto do valor do objeto correspondente.

A sintaxe de um item de formato é {índice[,alinhamento][:formatString]}, que especifica um índice obrigatório, o comprimento opcional e o alinhamento do texto formatado e uma cadeia opcional de caracteres especificadores de formato que regem como o valor do objeto correspondente é formatado.

O .NET fornece amplo suporte à formatação, que é descrito com mais detalhes nos tópicos de formatação a seguir.

Para obter mais informações sobre o terminador de linha, consulte a seção Comentários do método WriteLine que não usa parâmetros.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.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)

Origem:
Console.cs
Origem:
Console.cs
Origem:
Console.cs

Grava a representação de texto do objeto especificado, seguido pelo terminador de linha atual, no fluxo de saída padrão.

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

Parâmetros

value
Object

O valor a ser gravado.

Exceções

IOException

Ocorreu um erro de E/S.

Exemplos

O exemplo a seguir usa o método WriteLine(Object) para exibir cada valor em uma matriz de objetos no console.

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

Comentários

Se value for null, somente o terminador de linha será gravado. Caso contrário, o método ToString de value é chamado para produzir sua representação de cadeia de caracteres e a cadeia de caracteres resultante é gravada no fluxo de saída padrão.

Para obter mais informações sobre o terminador de linha, consulte a seção Comentários do método WriteLine que não usa parâmetros.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.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 não está em conformidade com CLS.

Grava a representação de texto dos objetos especificados e da lista de parâmetros de comprimento variável, seguido pelo terminador de linha atual, no fluxo de saída padrão usando as informações de formato especificadas.

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

Parâmetros

format
String

Uma cadeia de caracteres de formato composto.

arg0
Object

O primeiro objeto a ser gravado usando format.

arg1
Object

O segundo objeto a ser gravado usando format.

arg2
Object

O terceiro objeto a ser gravado usando format.

arg3
Object

O quarto objeto a ser gravado usando format.

Atributos
CLSCompliantAttribute

Exceções

IOException

Ocorreu um erro de E/S.

ArgumentNullException

format é null.

FormatException

A especificação de formato em format é inválida.

Exemplos

O exemplo a seguir ilustra o uso de argumentos variáveis com o método WriteLine(String, Object, Object, Object, Object). O método é chamado com uma cadeia de caracteres de formato composto e cinco itens 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

Comentários

Observação

Essa API não é compatível com CLS. A alternativa compatível com CLS é Console.WriteLine(String, Object[]). Os compiladores C# e Visual Basic resolvem automaticamente uma chamada para esse método como uma chamada para Console.WriteLine(String, Object[]).

Esse método usa o recurso de formatação composta do .NET para converter o valor de um objeto em sua representação de texto e inserir essa representação em uma cadeia de caracteres. A cadeia de caracteres resultante é gravada no fluxo de saída.

O parâmetro format consiste em zero ou mais execuções de texto intermixado com zero ou mais espaços reservados indexados, chamados itens de formato, que correspondem a um objeto na lista de parâmetros desse método. O processo de formatação substitui cada item de formato pela representação de texto do valor do objeto correspondente.

A sintaxe de um item de formato é {índice[,alinhamento][:formatString]}, que especifica um índice obrigatório, o comprimento opcional e o alinhamento do texto formatado e uma cadeia opcional de caracteres especificadores de formato que regem como o valor do objeto correspondente é formatado.

O .NET fornece amplo suporte à formatação, que é descrito com mais detalhes nos tópicos de formatação a seguir.

Para obter mais informações sobre o terminador de linha, consulte a seção Comentários do método WriteLine que não usa parâmetros.

Notas aos Chamadores

Esse método é marcado com a palavra-chave vararg, o que significa que ele dá suporte a um número variável de parâmetros. O método pode ser chamado do Visual C++, mas não pode ser chamado de código C# ou Visual Basic. Os compiladores C# e Visual Basic resolvem chamadas para WriteLine(String, Object, Object, Object, Object) como chamadas para WriteLine(String, Object[]).

Confira também

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.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