İngilizce dilinde oku

Aracılığıyla paylaş

Console.WriteLine Yöntem

  • Başvuru

Tanım

Ad Alanı:
System
Bütünleştirilmiş Kod:
System.Console.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.dll

Belirtilen verileri ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.

Aşırı Yüklemeler

WriteLine(String, Object, Object)

Belirtilen nesnelerin metin gösterimini ve ardından geçerli satır sonlandırıcısını belirtilen biçim bilgilerini kullanarak standart çıkış akışına yazar.
WriteLine(String)

Belirtilen dize değerini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.
WriteLine(Char[], Int32, Int32)

Belirtilen Unicode karakterlerinin alt dizisini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.
WriteLine(String, ReadOnlySpan<Object>)

Belirtilen nesne aralığının metin gösterimini ve ardından geçerli satır sonlandırıcısını belirtilen biçim bilgilerini kullanarak standart çıkış akışına yazar.
WriteLine(String, Object[])

Belirtilen nesne dizisinin metin gösterimini ve ardından geçerli satır sonlandırıcısını belirtilen biçim bilgilerini kullanarak standart çıkış akışına yazar.
WriteLine(String, Object)

Belirtilen nesnenin metin gösterimini ve ardından geçerli satır sonlandırıcısını belirtilen biçim bilgilerini kullanarak standart çıkış akışına yazar.
WriteLine(UInt64)

Belirtilen 64 bit işaretsiz tamsayı değerinin metin gösterimini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.
WriteLine(UInt32)

Belirtilen 32 bit işaretsiz tamsayı değerinin metin gösterimini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.
WriteLine(Single)

Belirtilen tek duyarlıklı kayan nokta değerinin metin gösterimini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.
WriteLine(Double)

Belirtilen çift duyarlıklı kayan nokta değerinin metin gösterimini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.
WriteLine(Int64)

Belirtilen 64 bit imzalı tamsayı değerinin metin gösterimini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.
WriteLine(Int32)

Belirtilen 32 bit imzalı tamsayı değerinin metin gösterimini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.
WriteLine(Decimal)

Belirtilen Decimal değerinin metin gösterimini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.
WriteLine(Char[])

Belirtilen Unicode karakter dizisini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.
WriteLine(Char)

Belirtilen Unicode karakterini ve ardından geçerli satır sonlandırıcısını, değeri standart çıkış akışına yazar.
WriteLine(Boolean)

Belirtilen Boole değerinin metin gösterimini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.
WriteLine()

Geçerli satır sonlandırıcısını standart çıkış akışına yazar.
WriteLine(String, Object, Object, Object)

Belirtilen nesnelerin metin gösterimini ve ardından geçerli satır sonlandırıcısını belirtilen biçim bilgilerini kullanarak standart çıkış akışına yazar.
WriteLine(Object)

Belirtilen nesnenin metin gösterimini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.
WriteLine(String, Object, Object, Object, Object)

Belirtilen nesnelerin metin gösterimini ve değişken uzunluklu parametre listesini, ardından geçerli satır sonlandırıcısını belirtilen biçim bilgilerini kullanarak standart çıkış akışına yazar.

Açıklamalar

Varsayılan satır sonlandırıcısı, değeri satır başı ve ardından satır beslemesi (" C# dilinde "\r\n" veya Visual Basic'te vbCrLf) olan bir dizedir. Out özelliğinin TextWriter.NewLine özelliğini başka bir dizeye ayarlayarak satır sonlandırıcısını değiştirebilirsiniz.

WriteLine(String, Object, Object)

Kaynak:
Console.cs
Kaynak:
Console.cs
Kaynak:
Console.cs

Belirtilen nesnelerin metin gösterimini ve ardından geçerli satır sonlandırıcısını belirtilen biçim bilgilerini kullanarak standart çıkış akışına yazar.

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

Parametreler

format
String

Bileşik biçim dizesi.

arg0
Object

formatkullanılarak yazacak ilk nesne.

arg1
Object

formatkullanılarak yazacak ikinci nesne.

Özel durumlar

IOException

G/Ç hatası oluştu.

ArgumentNullException

format null.

FormatException

format biçim belirtimi geçersiz.

Örnekler

Aşağıdaki örnekte sayılar, tarihler ve numaralandırmalar için standart biçimlendirme tanımlayıcıları gösterilmektedir.

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

*/

Aşağıdaki örnek, 18% ipucu hesaplayan ve özgün ücretin miktarını, ipucunun miktarını ve toplam tutarı görüntülemek için WriteLine yöntemini kullanan bir ipucu hesaplayıcısıdır. Örnek, kullanıcının özgün ücretin miktarını komut satırı parametresi olarak sağlamasını gerektiren bir konsol uygulamasıdır.

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

Açıklamalar

Bu yöntem, bir nesnenin değerini metin gösterimine dönüştürmek ve bu gösterimi dizeye eklemek için .NET'in bileşik biçimlendirme özelliğini kullanır. Sonuçta elde edilen dize çıkış akışına yazılır.

format parametresi, bu yöntemin parametre listesindeki bir nesneye karşılık gelen, biçim öğeleri olarak adlandırılan sıfır veya daha fazla dizinli yer tutucuyla karıştırılmış sıfır veya daha fazla metin çalıştırmasını içerir. Biçimlendirme işlemi, her biçim öğesini karşılık gelen nesnenin değerinin metin gösterimiyle değiştirir.

Biçim öğesinin söz dizimi, [hizalama][formatString]dizindir. Bu, zorunlu dizini, isteğe bağlı olarak biçimlendirilmiş metnin uzunluğunu ve hizalamasını ve karşılık gelen nesnenin değerinin nasıl biçimlendirildiğini yöneten isteğe bağlı biçim tanımlayıcı karakter dizesini belirtir.

.NET, aşağıdaki biçimlendirme konularında daha ayrıntılı olarak açıklanan kapsamlı biçimlendirme desteği sağlar.

Satır sonlandırıcısı hakkında daha fazla bilgi için parametre içermeyen WriteLine yönteminin Açıklamalar bölümüne bakın.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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)

Kaynak:
Console.cs
Kaynak:
Console.cs
Kaynak:
Console.cs

Belirtilen dize değerini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.

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

Parametreler

value
String

Yazacak değer.

Özel durumlar

IOException

G/Ç hatası oluştu.

Örnekler

Örnek, satır sonlandırıcısını varsayılan "\r\n" veya vbCrLf değerinden "\r\n\r\n" veya vbCrLf + vbCrLfolarak değiştirir. Ardından konsolunda çıkışı görüntülemek için WriteLine() ve WriteLine(String) yöntemlerini çağırır.

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.

Açıklamalar

Değer nullise, standart çıkış akışına yalnızca satır sonlandırıcı yazılır.

Satır sonlandırıcısı hakkında daha fazla bilgi için WriteLine() yönteminin Açıklamalar bölümüne bakın.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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)

Kaynak:
Console.cs
Kaynak:
Console.cs
Kaynak:
Console.cs

Belirtilen Unicode karakterlerinin alt dizisini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.

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

Parametreler

buffer
Char[]

Unicode karakter dizisi.

index
Int32

bufferiçinde başlangıç konumu.

count
Int32

Yazacak karakter sayısı.

Özel durumlar

ArgumentNullException

buffer null.

ArgumentOutOfRangeException

index veya count sıfırdan küçüktür.

ArgumentException

index artı countbufferiçinde olmayan bir konum belirtin.

IOException

G/Ç hatası oluştu.

Açıklamalar

Bu yöntem, standart çıkış akışına bufferindex konumundan başlayarak count karakterler yazar.

Satır sonlandırıcısı hakkında daha fazla bilgi için parametre içermeyen WriteLine yönteminin Açıklamalar bölümüne bakın.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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>)

Belirtilen nesne aralığının metin gösterimini ve ardından geçerli satır sonlandırıcısını belirtilen biçim bilgilerini kullanarak standart çıkış akışına yazar.

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

Parametreler

format
String

Bileşik biçim dizesi.

arg
ReadOnlySpan<Object>

Biçim kullanılarak yazılacak nesnelerin yayılma alanı.

Şunlara uygulanır

.NET 9
Ürün Sürümler
.NET 9

WriteLine(String, Object[])

Kaynak:
Console.cs
Kaynak:
Console.cs
Kaynak:
Console.cs

Belirtilen nesne dizisinin metin gösterimini ve ardından geçerli satır sonlandırıcısını belirtilen biçim bilgilerini kullanarak standart çıkış akışına yazar.

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

Parametreler

format
String

Bileşik biçim dizesi.

arg
Object[]

formatkullanılarak yazacak nesne dizisi.

Özel durumlar

IOException

G/Ç hatası oluştu.

ArgumentNullException

format veya argnull.

FormatException

format biçim belirtimi geçersiz.

Örnekler

Aşağıdaki örnekte sayılar, tarihler ve numaralandırmalar için standart biçimlendirme tanımlayıcıları gösterilmektedir.

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

*/

Aşağıdaki örnek, 18% ipucu hesaplayan ve özgün ücretin miktarını, ipucunun miktarını ve toplam tutarı görüntülemek için WriteLine yöntemini kullanan bir ipucu hesaplayıcısıdır. Örnek, kullanıcının özgün ücretin miktarını komut satırı parametresi olarak sağlamasını gerektiren bir konsol uygulamasıdır.

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

Açıklamalar

Bu yöntem, bir nesnenin değerini metin gösterimine dönüştürmek ve bu gösterimi dizeye eklemek için .NET'in bileşik biçimlendirme özelliğini kullanır. Sonuçta elde edilen dize çıkış akışına yazılır.

format parametresi, bu yöntemin parametre listesindeki bir nesneye karşılık gelen, biçim öğeleri olarak adlandırılan sıfır veya daha fazla dizinli yer tutucuyla karıştırılmış sıfır veya daha fazla metin çalıştırmasını içerir. Biçimlendirme işlemi, her biçim öğesini karşılık gelen nesnenin değerinin metin gösterimiyle değiştirir.

Biçim öğesinin söz dizimi, [hizalama][formatString]dizindir. Bu, zorunlu dizini, isteğe bağlı olarak biçimlendirilmiş metnin uzunluğunu ve hizalamasını ve karşılık gelen nesnenin değerinin nasıl biçimlendirildiğini yöneten isteğe bağlı biçim tanımlayıcı karakter dizesini belirtir.

.NET, aşağıdaki biçimlendirme konularında daha ayrıntılı olarak açıklanan kapsamlı biçimlendirme desteği sağlar.

Satır sonlandırıcısı hakkında daha fazla bilgi için parametre içermeyen WriteLine yönteminin Açıklamalar bölümüne bakın.

Arayanlara Notlar

Bu yöntem C++ kodu tarafından çağrılmaz. C++ derleyicisi, WriteLine(String, Object, Object, Object, Object)çağrısı olarak bir dize ve dört veya daha fazla nesne parametresinin listesini içeren System.Console.WriteLine çağrılarını çözümler. WriteLine(String, Object)çağrısı olarak bir dize ve nesne dizisi içeren System.Console.WriteLine çağrılarını çözümler.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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)

Kaynak:
Console.cs
Kaynak:
Console.cs
Kaynak:
Console.cs

Belirtilen nesnenin metin gösterimini ve ardından geçerli satır sonlandırıcısını belirtilen biçim bilgilerini kullanarak standart çıkış akışına yazar.

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

Parametreler

format
String

Bileşik biçim dizesi.

arg0
Object

formatkullanılarak yazacak nesne.

Özel durumlar

IOException

G/Ç hatası oluştu.

ArgumentNullException

format null.

FormatException

format biçim belirtimi geçersiz.

Örnekler

Aşağıdaki örnek, rastgele oluşturulan beş Boolean değeri görüntülemek için WriteLine(String, Object) yöntemini çağırır.

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

Aşağıdaki örnekte geçerli tarihi görüntülemek için WriteLine(String, Object) yöntemi çağrılır. format bağımsız değişkenindeki biçim öğesinin, tarihi geçerli kültürün uzun tarih biçiminde görüntülemek için "D" standart tarih ve saat biçimi dizesi kullandığını unutmayın.

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

Açıklamalar

Bu yöntem, bir nesnenin değerini metin gösterimine dönüştürmek ve bu gösterimi dizeye eklemek için .NET'in bileşik biçimlendirme özelliğini kullanır. Sonuçta elde edilen dize çıkış akışına yazılır.

format parametresi, bu yöntemin parametre listesindeki bir nesneye karşılık gelen, biçim öğeleri olarak adlandırılan sıfır veya daha fazla dizinli yer tutucuyla karıştırılmış sıfır veya daha fazla metin çalıştırmasını içerir. Biçimlendirme işlemi, her biçim öğesini karşılık gelen nesnenin değerinin metin gösterimiyle değiştirir.

Biçim öğesinin söz dizimi, [hizalama][formatString]dizindir. Bu, zorunlu dizini, isteğe bağlı olarak biçimlendirilmiş metnin uzunluğunu ve hizalamasını ve karşılık gelen nesnenin değerinin nasıl biçimlendirildiğini yöneten isteğe bağlı biçim tanımlayıcı karakter dizesini belirtir.

.NET, aşağıdaki biçimlendirme konularında daha ayrıntılı olarak açıklanan kapsamlı biçimlendirme desteği sağlar.

Satır sonlandırıcısı hakkında daha fazla bilgi için parametre içermeyen WriteLine yönteminin Açıklamalar bölümüne bakın.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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)

Kaynak:
Console.cs
Kaynak:
Console.cs
Kaynak:
Console.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen 64 bit işaretsiz tamsayı değerinin metin gösterimini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.

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

Parametreler

value
UInt64

Yazacak değer.

Öznitelikler
CLSCompliantAttribute

Özel durumlar

IOException

G/Ç hatası oluştu.

Örnekler

Aşağıdaki örnek, 18% ipucu hesaplayan ve özgün ücretin miktarını, ipucunun miktarını ve toplam tutarı görüntülemek için WriteLine yöntemini kullanan bir ipucu hesaplayıcısıdır. Örnek, kullanıcının özgün ücretin miktarını komut satırı parametresi olarak sağlamasını gerektiren bir konsol uygulamasıdır.

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

Açıklamalar

value metin gösterimi, UInt64.ToString yöntemi çağrılarak oluşturulur.

Satır sonlandırıcısı hakkında daha fazla bilgi için parametre içermeyen WriteLine yönteminin Açıklamalar bölümüne bakın.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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)

Kaynak:
Console.cs
Kaynak:
Console.cs
Kaynak:
Console.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen 32 bit işaretsiz tamsayı değerinin metin gösterimini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.

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

Parametreler

value
UInt32

Yazacak değer.

Öznitelikler
CLSCompliantAttribute

Özel durumlar

IOException

G/Ç hatası oluştu.

Örnekler

Aşağıdaki örnek, 18% ipucu hesaplayan ve özgün ücretin miktarını, ipucunun miktarını ve toplam tutarı görüntülemek için WriteLine yöntemini kullanan bir ipucu hesaplayıcısıdır. Örnek, kullanıcının özgün ücretin miktarını komut satırı parametresi olarak sağlamasını gerektiren bir konsol uygulamasıdır.

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

Açıklamalar

value metin gösterimi, UInt32.ToString yöntemi çağrılarak oluşturulur.

Satır sonlandırıcısı hakkında daha fazla bilgi için parametre içermeyen WriteLine yönteminin Açıklamalar bölümüne bakın.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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)

Kaynak:
Console.cs
Kaynak:
Console.cs
Kaynak:
Console.cs

Belirtilen tek duyarlıklı kayan nokta değerinin metin gösterimini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.

C# 
public static void WriteLine (float value);

Parametreler

value
Single

Yazacak değer.

Özel durumlar

IOException

G/Ç hatası oluştu.

Örnekler

Aşağıdaki örnek, 18% ipucu hesaplayan ve özgün ücretin miktarını, ipucunun miktarını ve toplam tutarı görüntülemek için WriteLine yöntemini kullanan bir ipucu hesaplayıcısıdır. Örnek, kullanıcının özgün ücretin miktarını komut satırı parametresi olarak sağlamasını gerektiren bir konsol uygulamasıdır.

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

Açıklamalar

value metin gösterimi, Single.ToString yöntemi çağrılarak oluşturulur.

Satır sonlandırıcısı hakkında daha fazla bilgi için parametre içermeyen WriteLine yönteminin Açıklamalar bölümüne bakın.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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)

Kaynak:
Console.cs
Kaynak:
Console.cs
Kaynak:
Console.cs

Belirtilen çift duyarlıklı kayan nokta değerinin metin gösterimini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.

C# 
public static void WriteLine (double value);

Parametreler

value
Double

Yazacak değer.

Özel durumlar

IOException

G/Ç hatası oluştu.

Örnekler

Aşağıdaki örnek, 18% ipucu hesaplayan ve özgün ücretin miktarını, ipucunun miktarını ve toplam tutarı görüntülemek için WriteLine yöntemini kullanan bir ipucu hesaplayıcısıdır. Örnek, kullanıcının özgün ücretin miktarını komut satırı parametresi olarak sağlamasını gerektiren bir konsol uygulamasıdır.

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

Açıklamalar

value metin gösterimi, Double.ToString yöntemi çağrılarak oluşturulur.

Satır sonlandırıcısı hakkında daha fazla bilgi için parametre içermeyen WriteLine yönteminin Açıklamalar bölümüne bakın.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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)

Kaynak:
Console.cs
Kaynak:
Console.cs
Kaynak:
Console.cs

Belirtilen 64 bit imzalı tamsayı değerinin metin gösterimini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.

C# 
public static void WriteLine (long value);

Parametreler

value
Int64

Yazacak değer.

Özel durumlar

IOException

G/Ç hatası oluştu.

Örnekler

Aşağıdaki örnek, 18% ipucu hesaplayan ve özgün ücretin miktarını, ipucunun miktarını ve toplam tutarı görüntülemek için WriteLine yöntemini kullanan bir ipucu hesaplayıcısıdır. Örnek, kullanıcının özgün ücretin miktarını komut satırı parametresi olarak sağlamasını gerektiren bir konsol uygulamasıdır.

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

Açıklamalar

value metin gösterimi, Int64.ToString yöntemi çağrılarak oluşturulur.

Satır sonlandırıcısı hakkında daha fazla bilgi için parametre içermeyen WriteLine yönteminin Açıklamalar bölümüne bakın.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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)

Kaynak:
Console.cs
Kaynak:
Console.cs
Kaynak:
Console.cs

Belirtilen 32 bit imzalı tamsayı değerinin metin gösterimini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.

C# 
public static void WriteLine (int value);

Parametreler

value
Int32

Yazacak değer.

Özel durumlar

IOException

G/Ç hatası oluştu.

Örnekler

Aşağıdaki örnek, 18% ipucu hesaplayan ve özgün ücretin miktarını, ipucunun miktarını ve toplam tutarı görüntülemek için WriteLine yöntemini kullanan bir ipucu hesaplayıcısıdır. Örnek, kullanıcının özgün ücretin miktarını komut satırı parametresi olarak sağlamasını gerektiren bir konsol uygulamasıdır.

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

Açıklamalar

value metin gösterimi, Int32.ToString yöntemi çağrılarak oluşturulur.

Satır sonlandırıcısı hakkında daha fazla bilgi için parametre içermeyen WriteLine yönteminin Açıklamalar bölümüne bakın.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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)

Kaynak:
Console.cs
Kaynak:
Console.cs
Kaynak:
Console.cs

Belirtilen Decimal değerinin metin gösterimini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.

C# 
public static void WriteLine (decimal value);

Parametreler

value
Decimal

Yazacak değer.

Özel durumlar

IOException

G/Ç hatası oluştu.

Örnekler

Aşağıdaki örnek, 18% ipucu hesaplayan ve özgün ücretin miktarını, ipucunun miktarını ve toplam tutarı görüntülemek için WriteLine yöntemini kullanan bir ipucu hesaplayıcısıdır. Örnek, kullanıcının özgün ücretin miktarını komut satırı parametresi olarak sağlamasını gerektiren bir konsol uygulamasıdır.

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

Açıklamalar

value metin gösterimi, Decimal.ToString yöntemi çağrılarak oluşturulur.

Satır sonlandırıcısı hakkında daha fazla bilgi için parametre içermeyen WriteLine yönteminin Açıklamalar bölümüne bakın.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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[])

Kaynak:
Console.cs
Kaynak:
Console.cs
Kaynak:
Console.cs

Belirtilen Unicode karakter dizisini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.

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

Parametreler

buffer
Char[]

Unicode karakter dizisi.

Özel durumlar

IOException

G/Ç hatası oluştu.

Açıklamalar

Satır sonlandırıcısı hakkında daha fazla bilgi için parametre içermeyen WriteLine yönteminin Açıklamalar bölümüne bakın.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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)

Kaynak:
Console.cs
Kaynak:
Console.cs
Kaynak:
Console.cs

Belirtilen Unicode karakterini ve ardından geçerli satır sonlandırıcısını, değeri standart çıkış akışına yazar.

C# 
public static void WriteLine (char value);

Parametreler

value
Char

Yazacak değer.

Özel durumlar

IOException

G/Ç hatası oluştu.

Örnekler

Aşağıdaki örnek, 18% ipucu hesaplayan ve özgün ücretin miktarını, ipucunun miktarını ve toplam tutarı görüntülemek için WriteLine yöntemini kullanan bir ipucu hesaplayıcısıdır. Örnek, kullanıcının özgün ücretin miktarını komut satırı parametresi olarak sağlamasını gerektiren bir konsol uygulamasıdır.

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

Açıklamalar

Satır sonlandırıcısı hakkında daha fazla bilgi için parametre içermeyen WriteLine yönteminin Açıklamalar bölümüne bakın.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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)

Kaynak:
Console.cs
Kaynak:
Console.cs
Kaynak:
Console.cs

Belirtilen Boole değerinin metin gösterimini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.

C# 
public static void WriteLine (bool value);

Parametreler

value
Boolean

Yazacak değer.

Özel durumlar

IOException

G/Ç hatası oluştu.

Örnekler

Aşağıdaki örnek on rastgele tamsayı oluşturur ve eşit olup olmadıklarını belirtmek için Console.WriteLine(Boolean) yöntemini kullanır.

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

Açıklamalar

value metin gösterimi, Boolean.ToString yöntemi çağrılarak oluşturulur.

Satır sonlandırıcısı hakkında daha fazla bilgi için parametre içermeyen WriteLine yönteminin Açıklamalar bölümüne bakın.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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()

Kaynak:
Console.cs
Kaynak:
Console.cs
Kaynak:
Console.cs

Geçerli satır sonlandırıcısını standart çıkış akışına yazar.

C# 
public static void WriteLine ();

Özel durumlar

IOException

G/Ç hatası oluştu.

Örnekler

Örnek, satır sonlandırıcısını varsayılan "\r\n" veya vbCrLf değerinden "\r\n\r\n" veya vbCrLf + vbCrLfolarak değiştirir. Ardından konsolunda çıkışı görüntülemek için WriteLine() ve WriteLine(String) yöntemlerini çağırır.

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.

Açıklamalar

Varsayılan satır sonlandırıcısı, değeri satır başı ve ardından satır beslemesi (" C# dilinde "\r\n" veya Visual Basic'te vbCrLf) olan bir dizedir. Out özelliğinin TextWriter.NewLine özelliğini başka bir dizeye ayarlayarak satır sonlandırıcısını değiştirebilirsiniz. Örnek bir çizim sağlar.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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)

Kaynak:
Console.cs
Kaynak:
Console.cs
Kaynak:
Console.cs

Belirtilen nesnelerin metin gösterimini ve ardından geçerli satır sonlandırıcısını belirtilen biçim bilgilerini kullanarak standart çıkış akışına yazar.

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

Parametreler

format
String

Bileşik biçim dizesi.

arg0
Object

formatkullanılarak yazacak ilk nesne.

arg1
Object

formatkullanılarak yazacak ikinci nesne.

arg2
Object

formatkullanılarak yazacak üçüncü nesne.

Özel durumlar

IOException

G/Ç hatası oluştu.

ArgumentNullException

format null.

FormatException

format biçim belirtimi geçersiz.

Örnekler

Aşağıdaki örnekte sayılar, tarihler ve numaralandırmalar için standart biçimlendirme tanımlayıcıları gösterilmektedir.

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

*/

Aşağıdaki örnek, 18% ipucu hesaplayan ve özgün ücretin miktarını, ipucunun miktarını ve toplam tutarı görüntülemek için WriteLine yöntemini kullanan bir ipucu hesaplayıcısıdır. Örnek, kullanıcının özgün ücretin miktarını komut satırı parametresi olarak sağlamasını gerektiren bir konsol uygulamasıdır.

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

Açıklamalar

Bu yöntem, bir nesnenin değerini metin gösterimine dönüştürmek ve bu gösterimi dizeye eklemek için .NET'in bileşik biçimlendirme özelliğini kullanır. Sonuçta elde edilen dize çıkış akışına yazılır.

format parametresi, bu yöntemin parametre listesindeki bir nesneye karşılık gelen, biçim öğeleri olarak adlandırılan sıfır veya daha fazla dizinli yer tutucuyla karıştırılmış sıfır veya daha fazla metin çalıştırmasını içerir. Biçimlendirme işlemi, her biçim öğesini karşılık gelen nesnenin değerinin metin gösterimiyle değiştirir.

Biçim öğesinin söz dizimi, [hizalama][formatString]dizindir. Bu, zorunlu dizini, isteğe bağlı olarak biçimlendirilmiş metnin uzunluğunu ve hizalamasını ve karşılık gelen nesnenin değerinin nasıl biçimlendirildiğini yöneten isteğe bağlı biçim tanımlayıcı karakter dizesini belirtir.

.NET, aşağıdaki biçimlendirme konularında daha ayrıntılı olarak açıklanan kapsamlı biçimlendirme desteği sağlar.

Satır sonlandırıcısı hakkında daha fazla bilgi için parametre içermeyen WriteLine yönteminin Açıklamalar bölümüne bakın.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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)

Kaynak:
Console.cs
Kaynak:
Console.cs
Kaynak:
Console.cs

Belirtilen nesnenin metin gösterimini ve ardından geçerli satır sonlandırıcısını standart çıkış akışına yazar.

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

Parametreler

value
Object

Yazacak değer.

Özel durumlar

IOException

G/Ç hatası oluştu.

Örnekler

Aşağıdaki örnek, konsolda bir nesne dizisindeki her değeri görüntülemek için WriteLine(Object) yöntemini kullanır.

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

Açıklamalar

value nullise, yalnızca satır sonlandırıcı yazılır. Aksi takdirde, dize gösterimini oluşturmak için valueToString yöntemi çağrılır ve sonuçta elde edilen dize standart çıkış akışına yazılır.

Satır sonlandırıcısı hakkında daha fazla bilgi için parametre içermeyen WriteLine yönteminin Açıklamalar bölümüne bakın.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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)

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen nesnelerin metin gösterimini ve değişken uzunluklu parametre listesini, ardından geçerli satır sonlandırıcısını belirtilen biçim bilgilerini kullanarak standart çıkış akışına yazar.

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

Parametreler

format
String

Bileşik biçim dizesi.

arg0
Object

formatkullanılarak yazacak ilk nesne.

arg1
Object

formatkullanılarak yazacak ikinci nesne.

arg2
Object

formatkullanılarak yazacak üçüncü nesne.

arg3
Object

formatkullanılarak yazacak dördüncü nesne.

Öznitelikler
CLSCompliantAttribute

Özel durumlar

IOException

G/Ç hatası oluştu.

ArgumentNullException

format null.

FormatException

format biçim belirtimi geçersiz.

Örnekler

Aşağıdaki örnekte, WriteLine(String, Object, Object, Object, Object) yöntemiyle değişken bağımsız değişkenlerinin kullanımı gösterilmektedir. yöntemi bileşik biçim dizesi ve beş biçim öğesiyle çağrılır.

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

Açıklamalar

Not

Bu API CLS uyumlu değil. CLS uyumlu alternatif Console.WriteLine(String, Object[]). C# ve Visual Basic derleyicileri, bu yönteme yapılan çağrıyı Console.WriteLine(String, Object[])çağrısı olarak otomatik olarak çözümler.

Bu yöntem, bir nesnenin değerini metin gösterimine dönüştürmek ve bu gösterimi dizeye eklemek için .NET'in bileşik biçimlendirme özelliğini kullanır. Sonuçta elde edilen dize çıkış akışına yazılır.

format parametresi, bu yöntemin parametre listesindeki bir nesneye karşılık gelen, biçim öğeleri olarak adlandırılan sıfır veya daha fazla dizinli yer tutucuyla karıştırılmış sıfır veya daha fazla metin çalıştırmasını içerir. Biçimlendirme işlemi, her biçim öğesini karşılık gelen nesnenin değerinin metin gösterimiyle değiştirir.

Biçim öğesinin söz dizimi, [hizalama][formatString]dizindir. Bu, zorunlu dizini, isteğe bağlı olarak biçimlendirilmiş metnin uzunluğunu ve hizalamasını ve karşılık gelen nesnenin değerinin nasıl biçimlendirildiğini yöneten isteğe bağlı biçim tanımlayıcı karakter dizesini belirtir.

.NET, aşağıdaki biçimlendirme konularında daha ayrıntılı olarak açıklanan kapsamlı biçimlendirme desteği sağlar.

Satır sonlandırıcısı hakkında daha fazla bilgi için parametre içermeyen WriteLine yönteminin Açıklamalar bölümüne bakın.

Arayanlara Notlar

Bu yöntem vararg anahtar sözcüğüyle işaretlenir, yani değişken sayıda parametreyi destekler. Yöntemi Visual C++'tan çağrılabilir, ancak C# veya Visual Basic kodundan çağrılamaz. C# ve Visual Basic derleyicileri, WriteLine(String, Object[])çağrısı olarak WriteLine(String, Object, Object, Object, Object) çağrılarını çözümler.

Ayrıca bkz.

Şunlara uygulanır

.NET Framework 4.8.1 ve diğer sürümler
Ürün Sürümler
.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