TextWriter.WriteLine Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Metin akışına veri yazar ve ardından bir satır sonlandırıcısı ekler.
Aşırı Yüklemeler
WriteLine(String, Object, Object) |
Yöntemiyle aynı semantiği Format(String, Object, Object) kullanarak metin akışına biçimlendirilmiş bir dize ve yeni bir satır yazar. |
WriteLine(Char[], Int32, Int32) |
Metin akışına karakterlerin bir alt dizisini ve ardından bir satır sonlandırıcısını yazar. |
WriteLine(String, ReadOnlySpan<Object>) | |
WriteLine(String, Object[]) |
ile aynı semantiği Format(String, Object)kullanarak metin akışına biçimlendirilmiş bir dize ve yeni bir satır yazar. |
WriteLine(String, Object) |
Yöntemiyle aynı semantiği Format(String, Object) kullanarak metin akışına biçimlendirilmiş bir dize ve yeni bir satır yazar. |
WriteLine(UInt64) |
8 baytlık işaretsiz tamsayının metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı ekler. |
WriteLine(String, Object, Object, Object) |
ile aynı semantiği Format(String, Object)kullanarak metin akışına biçimlendirilmiş bir dize ve yeni bir satır yazar. |
WriteLine(UInt32) |
4 baytlık işaretsiz tamsayının metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı ekler. |
WriteLine(StringBuilder) |
Bir dize oluşturucusunun metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı ekler. |
WriteLine(String) |
Metin akışına bir dize ve ardından bir satır sonlandırıcı yazar. |
WriteLine(Single) |
Metin akışına 4 baytlık kayan nokta değerinin metin gösterimini ve ardından bir çizgi sonlandırıcısını yazar. |
WriteLine(Double) |
8 baytlık kayan nokta değerinin metin gösterimini metin akışına yazar ve ardından bir çizgi sonlandırıcısı ekler. |
WriteLine(Object) |
Bir nesnenin metin gösterimini, bu nesnede yöntemini çağırarak metin akışına |
WriteLine(Int64) |
Metin akışına 8 baytlık imzalı tamsayının metin gösterimini ve ardından bir satır sonlandırıcısını yazar. |
WriteLine(Int32) |
Metin akışına 4 baytlık imzalı bir tamsayının metin gösterimini ve ardından bir satır sonlandırıcısını yazar. |
WriteLine(Decimal) |
Ondalık değerin metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı ekler. |
WriteLine(Char[]) |
Metin akışına bir karakter dizisi ve ardından bir satır sonlandırıcı yazar. |
WriteLine(Char) |
Metin akışına bir karakter ve ardından bir satır sonlandırıcı yazar. |
WriteLine(Boolean) |
Bir |
WriteLine() |
Metin akışına bir satır sonlandırıcı yazar. |
WriteLine(ReadOnlySpan<Char>) |
Bir karakter aralığının metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı ekler. |
WriteLine(String, Object, Object)
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
Yöntemiyle aynı semantiği Format(String, Object, Object) kullanarak metin akışına biçimlendirilmiş bir dize ve yeni bir satır yazar.
public:
virtual void WriteLine(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public virtual void WriteLine (string format, object arg0, object arg1);
public virtual void WriteLine (string format, object? arg0, object? arg1);
abstract member WriteLine : string * obj * obj -> unit
override this.WriteLine : string * obj * obj -> unit
Public Overridable Sub WriteLine (format As String, arg0 As Object, arg1 As Object)
Parametreler
- format
- String
Bileşik biçim dizesi.
- arg0
- Object
Biçimlendirilip yazacak ilk nesne.
- arg1
- Object
Biçimlendirilip yazacak ikinci nesne.
Özel durumlar
format
, null
değeridir.
Kapalı TextWriter .
Bir G/Ç hatası oluşur.
format
geçerli bir bileşik biçim dizesi değil.
-veya-
Biçim öğesinin dizini 0'dan (sıfır) küçüktür veya biçimlendirilecek nesne sayısından büyük veya buna eşittir (bu yöntem aşırı yüklemesi için ikidir).
Açıklamalar
Bu yöntem, bir nesnenin değerini dize gösterimine dönüştürmek ve bu gösterimi bir dizeye eklemek için bileşik biçimlendirme kullanır. .NET, aşağıdaki biçimlendirme konularında daha ayrıntılı olarak açıklanan kapsamlı biçimlendirme desteği sağlar:
Bileşik biçimlendirme özelliği hakkında daha fazla bilgi için bkz. Bileşik Biçimlendirme.
Sayısal biçim tanımlayıcıları hakkında daha fazla bilgi için bkz. Standart Sayısal Biçim Dizeleri ve Özel Sayısal Biçim Dizeleri.
Tarih ve saat biçimi tanımlayıcıları hakkında daha fazla bilgi için bkz. Standart Tarih ve Saat Biçim Dizelerive Özel Tarih ve Saat Biçimi Dizeleri.
Numaralandırma biçimi tanımlayıcıları hakkında daha fazla bilgi için bkz. Numaralandırma Biçimi Dizeleri.
Biçimlendirme hakkında daha fazla bilgi için bkz . Biçimlendirme Türleri.
parametresi, format
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 ilgili nesnenin değerinin dize gösterimiyle değiştirir.
Biçim öğesinin söz dizimi aşağıdaki gibidir:
{index[,length][:formatString]}
Köşeli parantezler içindeki öğeler isteğe bağlıdır. Aşağıdaki tablo her öğeyi açıklar. Bir biçim öğesinin söz dizimi de dahil olmak üzere bileşik biçimlendirme özelliği hakkında daha fazla bilgi için bkz. Bileşik Biçimlendirme.
Öğe | Açıklama |
---|---|
dizin | Biçimlendirilecek nesnenin parametre listesindeki sıfır tabanlı konum. Dizin tarafından belirtilen nesne isenull , biçim öğesi ile String.Emptydeğiştirilir. Bu aşırı yüklemenin parametre listesinde iki nesnesi olduğundan , dizinin değeri her zaman 0 veya 1 olmalıdır. Dizin konumunda parametre yoksa, bir FormatException oluşturulur. |
, uzunluk | Parametrenin dize gösterimindeki en az karakter sayısı. Pozitifse, parametre sağa hizalanır; negatifse sola hizalanır. |
:formatString | Biçimlendirilecek nesne tarafından desteklenen standart veya özel biçim dizesi. formatString için olası değerler, nesnenin ToString(string format) yöntemi tarafından desteklenen değerlerle aynıdır. formatString belirtilmezse ve biçimlendirilecek nesne arabirimi uygularsaIFormattable, null biçim dizesi olarak kullanılan parametrenin format değeri olarak IFormattable.ToString geçirilir. |
Baştaki ve sondaki ayraç karakterleri olan "{" ve "}" gereklidir. içinde format
tek bir değişmez ayraç karakteri belirtmek için iki baştaki veya sondaki ayraç karakterini belirtin; diğer bir ifadeyle "{{" veya "}}".
Bu yöntem, belirtilen dizede tek tek yeni satır karakterleri (onaltılık 0x000a) aramaz ve bunları ile NewLinedeğiştirmez.
Belirtilen bir nesneye biçim dizesinde başvurulmazsa, yoksayılır.
Satır sonlandırıcı alanı tarafından CoreNewLine tanımlanır.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Ayrıca bkz.
- StreamWriter
- StringWriter
- IFormatProvider
- Dosya ve Stream G/Ç
- Nasıl yapılır: Dosyadan Metin Okuma
- Nasıl yapılır: Bir Dosyaya Metin Yazma
Şunlara uygulanır
WriteLine(Char[], Int32, Int32)
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
Metin akışına bir karakter alt dizisi yazar ve ardından bir satır sonlandırıcısı yazar.
public:
virtual void WriteLine(cli::array <char> ^ buffer, int index, int count);
public virtual void WriteLine (char[] buffer, int index, int count);
abstract member WriteLine : char[] * int * int -> unit
override this.WriteLine : char[] * int * int -> unit
Public Overridable Sub WriteLine (buffer As Char(), index As Integer, count As Integer)
Parametreler
- buffer
- Char[]
Verilerin okunduğu karakter dizisi.
- index
- Int32
Verileri okumaya başlayabileceğiniz karakter konumu buffer
.
- count
- Int32
Yazacak karakter sayısı üst sınırı.
Özel durumlar
Arabellek uzunluğu eksi index
değeri değerinden count
küçük.
buffer
parametresidirnull
.
index
veya count
negatiftir.
Kapalı TextWriter .
Bir G/Ç hatası oluşur.
Açıklamalar
Bu yöntem, konumundan index
başlayarak karakter dizisinden buffer
buna TextWriter
veri karakterleri yazarcount
.
Bu aşırı yükleme, ve (index
+ count
arasındaki index
her karakter buffer
için yöntemini WriteLine çağırmaya Write(Char[]) eşdeğerdir.
Satır sonlandırıcı alanı tarafından CoreNewLine tanımlanır.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Ayrıca bkz.
- StreamWriter
- StringWriter
- Dosya ve Stream G/Ç
- Nasıl yapılır: Dosyadan Metin Okuma
- Nasıl yapılır: Bir Dosyaya Metin Yazma
Şunlara uygulanır
WriteLine(String, ReadOnlySpan<Object>)
public:
virtual void WriteLine(System::String ^ format, ReadOnlySpan<System::Object ^> arg);
public virtual void WriteLine (string format, scoped ReadOnlySpan<object?> arg);
abstract member WriteLine : string * ReadOnlySpan<obj> -> unit
override this.WriteLine : string * ReadOnlySpan<obj> -> unit
Public Overridable Sub WriteLine (format As String, arg As ReadOnlySpan(Of Object))
Parametreler
- format
- String
- arg
- ReadOnlySpan<Object>
Şunlara uygulanır
WriteLine(String, Object[])
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
ile aynı semantiği Format(String, Object)kullanarak metin akışına biçimlendirilmiş bir dize ve yeni bir satır yazar.
public:
virtual void WriteLine(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public virtual void WriteLine (string format, params object[] arg);
public virtual void WriteLine (string format, params object?[] arg);
abstract member WriteLine : string * obj[] -> unit
override this.WriteLine : string * obj[] -> unit
Public Overridable Sub WriteLine (format As String, ParamArray arg As Object())
Parametreler
- format
- String
Bileşik biçim dizesi.
- arg
- Object[]
Biçimlendirilip yazacak sıfır veya daha fazla nesne içeren bir nesne dizisi.
Özel durumlar
Dize veya nesne olarak null
geçirilir.
Kapalı TextWriter .
Bir G/Ç hatası oluşur.
format
geçerli bir bileşik biçim dizesi değil.
-veya-
Biçim öğesinin dizini 0'dan küçük (sıfır) veya dizinin uzunluğundan arg
büyük veya buna eşit.
Açıklamalar
Bu yöntem, bir nesnenin değerini dize gösterimine dönüştürmek ve bu gösterimi bir dizeye eklemek için bileşik biçimlendirme kullanır. .NET, aşağıdaki biçimlendirme konularında daha ayrıntılı olarak açıklanan kapsamlı biçimlendirme desteği sağlar:
Bileşik biçimlendirme özelliği hakkında daha fazla bilgi için bkz . Bileşik Biçimlendirme.
Sayısal biçim tanımlayıcıları hakkında daha fazla bilgi için bkz. Standart Sayısal Biçim Dizeleri ve Özel Sayısal Biçim Dizeleri.
Tarih ve saat biçimi tanımlayıcıları hakkında daha fazla bilgi için bkz. Standart Tarih ve Saat Biçimi Dizeleri ve Özel Tarih ve Saat Biçimi Dizeleri.
Numaralandırma biçimi tanımlayıcıları hakkında daha fazla bilgi için bkz. Numaralandırma Biçimi Dizeleri.
Biçimlendirme hakkında daha fazla bilgi için bkz . Biçimlendirme Türleri.
parametresi, format
bu yöntemin parametre listesindeki bir nesneye karşılık gelen, biçim öğeleri olarak adlandırılan sıfır veya daha fazla dizinlenmiş 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 dize gösterimiyle değiştirir.
Biçim öğesinin söz dizimi aşağıdaki gibidir:
{index[,length][:formatString]}
Köşeli parantezler içindeki öğeler isteğe bağlıdır. Aşağıdaki tablo her öğeyi açıklar. Bir biçim öğesinin söz dizimi de dahil olmak üzere bileşik biçimlendirme özelliği hakkında daha fazla bilgi için bkz . Bileşik Biçimlendirme.
Öğe | Açıklama |
---|---|
dizin | Biçimlendirilecek nesnenin parametre listesindeki sıfır tabanlı konum. Dizin tarafından belirtilen nesne isenull , biçim öğesi ile String.Emptydeğiştirilir. Bu aşırı yüklemenin parametre listesinde bir dizi olduğundan, dizinin değeri her zaman dizinin uzunluğundan küçük olmalıdır. Dizin konumunda parametre yoksa, bir FormatException oluşturulur. |
,uzunluk | Parametrenin dize gösterimindeki en az karakter sayısı. Pozitifse, parametre sağa hizalanır; negatifse sola hizalanır. |
:formatString | Biçimlendirilecek nesne tarafından desteklenen standart veya özel biçim dizesi. formatString için olası değerler, nesnenin ToString(string format) yöntemi tarafından desteklenen değerlerle aynıdır. formatString belirtilmezse ve biçimlendirilecek nesne arabirimini uygularsaIFormattable, null biçim dizesi olarak kullanılan parametrenin format değeri olarak IFormattable.ToString geçirilir. |
Baştaki ve sondaki ayraç karakterleri olan "{" ve "}" gereklidir. içinde format
tek bir değişmez ayraç karakteri belirtmek için, baştaki veya sondaki iki ayraç karakterini belirtin; yani, "{{" veya "}}".
Bu yöntem belirtilen dizede tek tek yeni satır karakterleri (onaltılık 0x000a) aramaz ve bunları ile NewLinedeğiştirmez.
Belirtilen bir nesneye biçim dizesinde başvurulmazsa, yoksayılır.
Satır sonlandırıcı alanı tarafından CoreNewLine tanımlanır.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Ayrıca bkz.
- StreamWriter
- StringWriter
- IFormatProvider
- Dosya ve Stream G/Ç
- Nasıl yapılır: Dosyadan Metin Okuma
- Nasıl yapılır: Bir Dosyaya Metin Yazma
Şunlara uygulanır
WriteLine(String, Object)
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
Yöntemiyle aynı semantiği Format(String, Object) kullanarak metin akışına biçimlendirilmiş bir dize ve yeni bir satır yazar.
public:
virtual void WriteLine(System::String ^ format, System::Object ^ arg0);
public virtual void WriteLine (string format, object arg0);
public virtual void WriteLine (string format, object? arg0);
abstract member WriteLine : string * obj -> unit
override this.WriteLine : string * obj -> unit
Public Overridable Sub WriteLine (format As String, arg0 As Object)
Parametreler
- format
- String
Bileşik biçim dizesi.
- arg0
- Object
Biçimlendirilip yazacak nesne.
Özel durumlar
format
, null
değeridir.
Kapalı TextWriter .
Bir G/Ç hatası oluşur.
format
geçerli bir bileşik biçim dizesi değil.
-veya-
Bir biçim öğesinin dizini 0'dan küçük (sıfır) veya biçimlendirilecek nesne sayısından büyük veya buna eşit (bu yöntem aşırı yüklemesi için bir tanedir).
Açıklamalar
Bu yöntem, bir nesnenin değerini dize gösterimine dönüştürmek ve bu gösterimi bir dizeye eklemek için bileşik biçimlendirme kullanır. .NET, aşağıdaki biçimlendirme konularında daha ayrıntılı olarak açıklanan kapsamlı biçimlendirme desteği sağlar:
Bileşik biçimlendirme özelliği hakkında daha fazla bilgi için bkz . Bileşik Biçimlendirme.
Sayısal biçim tanımlayıcıları hakkında daha fazla bilgi için bkz. Standart Sayısal Biçim Dizeleri ve Özel Sayısal Biçim Dizeleri.
Tarih ve saat biçimi tanımlayıcıları hakkında daha fazla bilgi için bkz. Standart Tarih ve Saat Biçimi Dizeleri ve Özel Tarih ve Saat Biçimi Dizeleri.
Numaralandırma biçimi tanımlayıcıları hakkında daha fazla bilgi için bkz. Numaralandırma Biçimi Dizeleri.
Biçimlendirme hakkında daha fazla bilgi için bkz . Biçimlendirme Türleri.
parametresi, format
bu yöntemin parametre listesindeki bir nesneye karşılık gelen, biçim öğeleri olarak adlandırılan sıfır veya daha fazla dizinlenmiş 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 dize gösterimiyle değiştirir.
Biçim öğesinin söz dizimi aşağıdaki gibidir:
{index[,length][:formatString]}
Köşeli parantezler içindeki öğeler isteğe bağlıdır. Aşağıdaki tablo her öğeyi açıklar. Bir biçim öğesinin söz dizimi de dahil olmak üzere bileşik biçimlendirme özelliği hakkında daha fazla bilgi için bkz . Bileşik Biçimlendirme.
Öğe | Açıklama |
---|---|
dizin | Biçimlendirilecek nesnenin parametre listesindeki sıfır tabanlı konum. Dizin tarafından belirtilen nesne isenull , biçim öğesi ile String.Emptydeğiştirilir. Bu aşırı yüklemenin parametre listesinde yalnızca tek bir nesnesi olduğundan , dizinin değeri her zaman 0 olmalıdır. Dizin konumunda parametre yoksa, bir FormatException oluşturulur. |
,uzunluk | Parametrenin dize gösterimindeki en az karakter sayısı. Pozitifse, parametre sağa hizalanır; negatifse sola hizalanır. |
:formatString | Biçimlendirilecek nesne tarafından desteklenen standart veya özel biçim dizesi. formatString için olası değerler, nesnenin ToString(string format) yöntemi tarafından desteklenen değerlerle aynıdır. formatString belirtilmezse ve biçimlendirilecek nesne arabirimini uygularsaIFormattable, null biçim dizesi olarak kullanılan parametrenin format değeri olarak IFormattable.ToString geçirilir. |
Baştaki ve sondaki ayraç karakterleri olan "{" ve "}" gereklidir. içinde format
tek bir değişmez ayraç karakteri belirtmek için, baştaki veya sondaki iki ayraç karakterini belirtin; yani, "{{" veya "}}".
Bu yöntem belirtilen dizede tek tek yeni satır karakterleri (onaltılık 0x000a) aramaz ve bunları ile NewLinedeğiştirmez.
Belirtilen bir nesneye biçim dizesinde başvurulmazsa, yoksayılır.
Satır sonlandırıcı alanı tarafından CoreNewLine tanımlanır.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Ayrıca bkz.
- StreamWriter
- StringWriter
- IFormatProvider
- Dosya ve Stream G/Ç
- Nasıl yapılır: Dosyadan Metin Okuma
- Nasıl yapılır: Bir Dosyaya Metin Yazma
Şunlara uygulanır
WriteLine(UInt64)
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
Önemli
Bu API, CLS uyumlu değildir.
8 baytlık işaretsiz tamsayının metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı ekler.
public:
virtual void WriteLine(System::UInt64 value);
[System.CLSCompliant(false)]
public virtual void WriteLine (ulong value);
[<System.CLSCompliant(false)>]
abstract member WriteLine : uint64 -> unit
override this.WriteLine : uint64 -> unit
Public Overridable Sub WriteLine (value As ULong)
Parametreler
- value
- UInt64
Yazacak 8 baytlık işaretsiz tamsayı.
- Öznitelikler
Özel durumlar
Kapalı TextWriter .
Bir G/Ç hatası oluşur.
Açıklamalar
Belirtilen değerin metin gösterimi yöntemi çağrılarak UInt64.ToString oluşturulur. FormatProvider özelliği değilse null
kültüre özgü biçimlendirmeyi belirtir.
Satır sonlandırıcı alanı tarafından CoreNewLine tanımlanır.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Ayrıca bkz.
- StreamWriter
- StringWriter
- IFormatProvider
- Dosya ve Stream G/Ç
- Nasıl yapılır: Dosyadan Metin Okuma
- Nasıl yapılır: Bir Dosyaya Metin Yazma
Şunlara uygulanır
WriteLine(String, Object, Object, Object)
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
ile aynı semantiği Format(String, Object)kullanarak metin akışına biçimlendirilmiş bir dize ve yeni bir satır yazar.
public:
virtual void WriteLine(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);
public virtual void WriteLine (string format, object arg0, object arg1, object arg2);
public virtual void WriteLine (string format, object? arg0, object? arg1, object? arg2);
abstract member WriteLine : string * obj * obj * obj -> unit
override this.WriteLine : string * obj * obj * obj -> unit
Public Overridable Sub WriteLine (format As String, arg0 As Object, arg1 As Object, arg2 As Object)
Parametreler
- format
- String
Bileşik biçim dizesi.
- arg0
- Object
Biçimlendirilip yazacak ilk nesne.
- arg1
- Object
Biçimlendirilip yazacak ikinci nesne.
- arg2
- Object
Biçimlendirilip yazacak üçüncü nesne.
Özel durumlar
format
, null
değeridir.
Kapalı TextWriter .
Bir G/Ç hatası oluşur.
format
geçerli bir bileşik biçim dizesi değil.
-veya-
Bir biçim öğesinin dizini 0'dan (sıfır) küçüktür veya biçimlendirilecek nesne sayısından büyük veya buna eşittir (bu yöntem aşırı yüklemesi için üçtür).
Açıklamalar
Bu yöntem, bir nesnenin değerini dize gösterimine dönüştürmek ve bu gösterimi bir dizeye eklemek için bileşik biçimlendirme kullanır. .NET, aşağıdaki biçimlendirme konularında daha ayrıntılı olarak açıklanan kapsamlı biçimlendirme desteği sağlar:
Bileşik biçimlendirme özelliği hakkında daha fazla bilgi için bkz. Bileşik Biçimlendirme.
Sayısal biçim tanımlayıcıları hakkında daha fazla bilgi için bkz. Standart Sayısal Biçim Dizeleri ve Özel Sayısal Biçim Dizeleri.
Tarih ve saat biçimi tanımlayıcıları hakkında daha fazla bilgi için bkz. Standart Tarih ve Saat Biçim Dizelerive Özel Tarih ve Saat Biçimi Dizeleri.
Numaralandırma biçimi tanımlayıcıları hakkında daha fazla bilgi için bkz. Numaralandırma Biçimi Dizeleri.
Biçimlendirme hakkında daha fazla bilgi için bkz . Biçimlendirme Türleri.
parametresi, format
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 ilgili nesnenin değerinin dize gösterimiyle değiştirir.
Biçim öğesinin söz dizimi aşağıdaki gibidir:
{index[,length][:formatString]}
Köşeli parantezler içindeki öğeler isteğe bağlıdır. Aşağıdaki tablo her öğeyi açıklar. Bir biçim öğesinin söz dizimi de dahil olmak üzere bileşik biçimlendirme özelliği hakkında daha fazla bilgi için bkz. Bileşik Biçimlendirme.
Öğe | Açıklama |
---|---|
dizin | Biçimlendirilecek nesnenin parametre listesindeki sıfır tabanlı konum. Dizin tarafından belirtilen nesne isenull , biçim öğesi ile String.Emptydeğiştirilir. Bu aşırı yüklemenin parametre listesinde üç nesnesi olduğundan , dizinin değeri her zaman 0, 1 veya 2 olmalıdır. Dizin konumunda parametre yoksa, bir FormatException oluşturulur. |
, uzunluk | Parametrenin dize gösterimindeki en az karakter sayısı. Pozitifse, parametre sağa hizalanır; negatifse sola hizalanır. |
:formatString | Biçimlendirilecek nesne tarafından desteklenen standart veya özel biçim dizesi. formatString için olası değerler, nesnenin ToString(string format) yöntemi tarafından desteklenen değerlerle aynıdır. formatString belirtilmezse ve biçimlendirilecek nesne arabirimi uygularsaIFormattable, null biçim dizesi olarak kullanılan parametrenin format değeri olarak IFormattable.ToString geçirilir. |
Baştaki ve sondaki ayraç karakterleri olan "{" ve "}" gereklidir. içinde format
tek bir değişmez ayraç karakteri belirtmek için iki baştaki veya sondaki ayraç karakterini belirtin; diğer bir ifadeyle "{{" veya "}}".
Bu yöntem, belirtilen dizede tek tek yeni satır karakterleri (onaltılık 0x000a) aramaz ve bunları ile NewLinedeğiştirmez.
Belirtilen bir nesneye biçim dizesinde başvurulmazsa, yoksayılır.
Satır sonlandırıcı alanı tarafından CoreNewLine tanımlanır.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Ayrıca bkz.
- StreamWriter
- StringWriter
- IFormatProvider
- Dosya ve Stream G/Ç
- Nasıl yapılır: Dosyadan Metin Okuma
- Nasıl yapılır: Bir Dosyaya Metin Yazma
Şunlara uygulanır
WriteLine(UInt32)
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
Önemli
Bu API, CLS uyumlu değildir.
4 baytlık işaretsiz tamsayının metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı ekler.
public:
virtual void WriteLine(System::UInt32 value);
[System.CLSCompliant(false)]
public virtual void WriteLine (uint value);
[<System.CLSCompliant(false)>]
abstract member WriteLine : uint32 -> unit
override this.WriteLine : uint32 -> unit
Public Overridable Sub WriteLine (value As UInteger)
Parametreler
- value
- UInt32
Yazacak 4 baytlık işaretsiz tamsayı.
- Öznitelikler
Özel durumlar
Kapalı TextWriter .
Bir G/Ç hatası oluşur.
Açıklamalar
Belirtilen değerin metin gösterimi yöntemi çağrılarak UInt32.ToString oluşturulur. FormatProvider özelliği değilse null
kültüre özgü biçimlendirmeyi belirtir.
Satır sonlandırıcı alanı tarafından CoreNewLine tanımlanır.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Ayrıca bkz.
- StreamWriter
- StringWriter
- IFormatProvider
- Dosya ve Stream G/Ç
- Nasıl yapılır: Dosyadan Metin Okuma
- Nasıl yapılır: Bir Dosyaya Metin Yazma
Şunlara uygulanır
WriteLine(StringBuilder)
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
Bir dize oluşturucusunun metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı ekler.
public:
virtual void WriteLine(System::Text::StringBuilder ^ value);
public virtual void WriteLine (System.Text.StringBuilder? value);
abstract member WriteLine : System.Text.StringBuilder -> unit
override this.WriteLine : System.Text.StringBuilder -> unit
Public Overridable Sub WriteLine (value As StringBuilder)
Parametreler
- value
- StringBuilder
Dize oluşturucusu olarak metin akışına yazacak dize.
Açıklamalar
Belirtilen değerin metin gösterimi yöntemi çağrılarak StringBuilder.ToString oluşturulur.
Satır sonlandırıcı alanı tarafından CoreNewLine tanımlanır.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Şunlara uygulanır
WriteLine(String)
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
Metin akışına bir dize ve ardından bir satır sonlandırıcı yazar.
public:
virtual void WriteLine(System::String ^ value);
public virtual void WriteLine (string value);
public virtual void WriteLine (string? value);
abstract member WriteLine : string -> unit
override this.WriteLine : string -> unit
Public Overridable Sub WriteLine (value As String)
Parametreler
- value
- String
Yazılacak dize. ise value
null
, yalnızca satır sonlandırıcısı yazılır.
Özel durumlar
Kapalı TextWriter .
Bir G/Ç hatası oluşur.
Açıklamalar
Bu aşırı yükleme, aşırı yüklemeye eşdeğerdir Write(Char[]) .
Satır sonlandırıcı alanı tarafından CoreNewLine tanımlanır.
Bu yöntem, belirtilen dizede tek tek yeni satır karakterleri (onaltılık 0x000a) aramaz ve bunları ile NewLinedeğiştirmez.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Ayrıca bkz.
- StreamWriter
- StringWriter
- Dosya ve Stream G/Ç
- Nasıl yapılır: Dosyadan Metin Okuma
- Nasıl yapılır: Bir Dosyaya Metin Yazma
Şunlara uygulanır
WriteLine(Single)
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
Metin akışına 4 baytlık kayan nokta değerinin metin gösterimini ve ardından bir çizgi sonlandırıcısını yazar.
public:
virtual void WriteLine(float value);
public virtual void WriteLine (float value);
abstract member WriteLine : single -> unit
override this.WriteLine : single -> unit
Public Overridable Sub WriteLine (value As Single)
Parametreler
- value
- Single
Yazacak 4 baytlık kayan nokta değeri.
Özel durumlar
Kapalı TextWriter .
Bir G/Ç hatası oluşur.
Açıklamalar
FormatProvider özelliği değilse null
kültüre özgü biçimlendirmeyi belirtir. Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Satır sonlandırıcı alanı tarafından CoreNewLine tanımlanır.
Ayrıca bkz.
- StreamWriter
- StringWriter
- IFormatProvider
- Dosya ve Stream G/Ç
- Nasıl yapılır: Dosyadan Metin Okuma
- Nasıl yapılır: Bir Dosyaya Metin Yazma
Şunlara uygulanır
WriteLine(Double)
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
8 baytlık kayan nokta değerinin metin gösterimini metin akışına yazar ve ardından bir çizgi sonlandırıcısı yazar.
public:
virtual void WriteLine(double value);
public virtual void WriteLine (double value);
abstract member WriteLine : double -> unit
override this.WriteLine : double -> unit
Public Overridable Sub WriteLine (value As Double)
Parametreler
- value
- Double
Yazacak 8 baytlık kayan nokta değeri.
Özel durumlar
Kapalı TextWriter .
Bir G/Ç hatası oluşur.
Açıklamalar
FormatProvider özelliği değilsenull
, kültüre özgü biçimlendirmeyi belirtir. Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Satır sonlandırıcı alanı tarafından CoreNewLine tanımlanır.
Ayrıca bkz.
- StreamWriter
- StringWriter
- IFormatProvider
- Dosya ve Stream G/Ç
- Nasıl yapılır: Dosyadan Metin Okuma
- Nasıl yapılır: Bir Dosyaya Metin Yazma
Şunlara uygulanır
WriteLine(Object)
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
Bir nesnenin metin gösterimini, bu nesne üzerinde yöntemini çağırarak ToString
ve ardından bir satır sonlandırıcısı yazarak metin akışına yazar.
public:
virtual void WriteLine(System::Object ^ value);
public virtual void WriteLine (object value);
public virtual void WriteLine (object? value);
abstract member WriteLine : obj -> unit
override this.WriteLine : obj -> unit
Public Overridable Sub WriteLine (value As Object)
Parametreler
- value
- Object
Yazacak nesne. ise value
null
, yalnızca satır sonlandırıcı yazılır.
Özel durumlar
Kapalı TextWriter .
Bir G/Ç hatası oluşur.
Açıklamalar
Bu aşırı yükleme, aşırı yüklemeye eşdeğerdir Write(String, Object) . FormatProvider özelliği değilsenull
, kültüre özgü biçimlendirmeyi belirtir.
Satır sonlandırıcı alanı tarafından CoreNewLine tanımlanır.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Ayrıca bkz.
- StreamWriter
- StringWriter
- IFormatProvider
- Dosya ve Stream G/Ç
- Nasıl yapılır: Dosyadan Metin Okuma
- Nasıl yapılır: Bir Dosyaya Metin Yazma
Şunlara uygulanır
WriteLine(Int64)
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
Metin akışına 8 bayt imzalı bir tamsayının metin gösterimini ve ardından bir satır sonlandırıcısını yazar.
public:
virtual void WriteLine(long value);
public virtual void WriteLine (long value);
abstract member WriteLine : int64 -> unit
override this.WriteLine : int64 -> unit
Public Overridable Sub WriteLine (value As Long)
Parametreler
- value
- Int64
Yazacak 8 baytlık işaretli tamsayı.
Özel durumlar
Kapalı TextWriter .
Bir G/Ç hatası oluşur.
Açıklamalar
Belirtilen değerin metin gösterimi yöntemi çağrılarak Int64.ToString oluşturulur. TextWriter.FormatProvider özelliği değilsenull
, kültüre özgü biçimlendirmeyi belirtir.
Satır sonlandırıcı alanı tarafından CoreNewLine tanımlanır.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Ayrıca bkz.
- StreamWriter
- StringWriter
- IFormatProvider
- Dosya ve Stream G/Ç
- Nasıl yapılır: Dosyadan Metin Okuma
- Nasıl yapılır: Bir Dosyaya Metin Yazma
Şunlara uygulanır
WriteLine(Int32)
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
4 bayt imzalı tamsayının metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı yazar.
public:
virtual void WriteLine(int value);
public virtual void WriteLine (int value);
abstract member WriteLine : int -> unit
override this.WriteLine : int -> unit
Public Overridable Sub WriteLine (value As Integer)
Parametreler
- value
- Int32
Yazacak 4 baytlık işaretli tamsayı.
Özel durumlar
Kapalı TextWriter .
Bir G/Ç hatası oluşur.
Açıklamalar
Belirtilen değerin metin gösterimi yöntemi çağrılarak Int32.ToString oluşturulur. TextWriter.FormatProvider özelliği değilsenull
, kültüre özgü biçimlendirmeyi belirtir.
Satır sonlandırıcı alanı tarafından CoreNewLine tanımlanır.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Ayrıca bkz.
- StreamWriter
- StringWriter
- IFormatProvider
- Dosya ve Stream G/Ç
- Nasıl yapılır: Dosyadan Metin Okuma
- Nasıl yapılır: Bir Dosyaya Metin Yazma
Şunlara uygulanır
WriteLine(Decimal)
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
Ondalık değerin metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı yazar.
public:
virtual void WriteLine(System::Decimal value);
public virtual void WriteLine (decimal value);
abstract member WriteLine : decimal -> unit
override this.WriteLine : decimal -> unit
Public Overridable Sub WriteLine (value As Decimal)
Parametreler
- value
- Decimal
Yazacak ondalık değer.
Özel durumlar
Kapalı TextWriter .
Bir G/Ç hatası oluşur.
Açıklamalar
FormatProvider özelliği değilsenull
, kültüre özgü biçimlendirmeyi belirtir. Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Satır sonlandırıcı alanı tarafından CoreNewLine tanımlanır.
Ayrıca bkz.
- StreamWriter
- StringWriter
- IFormatProvider
- Dosya ve Stream G/Ç
- Nasıl yapılır: Dosyadan Metin Okuma
- Nasıl yapılır: Bir Dosyaya Metin Yazma
Şunlara uygulanır
WriteLine(Char[])
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
Metin akışına bir karakter dizisi yazar ve ardından bir satır sonlandırıcısı yazar.
public:
virtual void WriteLine(cli::array <char> ^ buffer);
public virtual void WriteLine (char[] buffer);
public virtual void WriteLine (char[]? buffer);
abstract member WriteLine : char[] -> unit
override this.WriteLine : char[] -> unit
Public Overridable Sub WriteLine (buffer As Char())
Parametreler
- buffer
- Char[]
Verilerin okunduğu karakter dizisi.
Özel durumlar
Kapalı TextWriter .
Bir G/Ç hatası oluşur.
Açıklamalar
içindeki buffer
tüm karakterler temel alınan akışa yazılır. Karakter dizisi ise null
, yalnızca satır sonlandırıcı yazılır.
Bu aşırı yükleme ile eşdeğerdir Write(Char[]) ve bunu izler WriteLine() .
Satır sonlandırıcı alanı tarafından CoreNewLine tanımlanır.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Ayrıca bkz.
- StreamWriter
- StringWriter
- Dosya ve Stream G/Ç
- Nasıl yapılır: Dosyadan Metin Okuma
- Nasıl yapılır: Bir Dosyaya Metin Yazma
Şunlara uygulanır
WriteLine(Char)
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
Metin akışına bir karakter yazar ve ardından bir satır sonlandırıcısı yazar.
public:
virtual void WriteLine(char value);
public virtual void WriteLine (char value);
abstract member WriteLine : char -> unit
override this.WriteLine : char -> unit
Public Overridable Sub WriteLine (value As Char)
Parametreler
- value
- Char
Metin akışına yazacak karakter.
Özel durumlar
Kapalı TextWriter .
Bir G/Ç hatası oluşur.
Açıklamalar
Bu aşırı yükleme ile eşdeğerdir Write(Char) ve bunu izler WriteLine() .
Satır sonlandırıcı alanı tarafından CoreNewLine tanımlanır.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Ayrıca bkz.
- StreamWriter
- StringWriter
- Dosya ve Stream G/Ç
- Nasıl yapılır: Dosyadan Metin Okuma
- Nasıl yapılır: Bir Dosyaya Metin Yazma
Şunlara uygulanır
WriteLine(Boolean)
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
Bir Boolean
değerin metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı yazar.
public:
virtual void WriteLine(bool value);
public virtual void WriteLine (bool value);
abstract member WriteLine : bool -> unit
override this.WriteLine : bool -> unit
Public Overridable Sub WriteLine (value As Boolean)
Parametreler
- value
- Boolean
Boolean
Yazacak değer.
Özel durumlar
Kapalı TextWriter .
Bir G/Ç hatası oluşur.
Açıklamalar
Belirtilen değerin metin gösterimi yöntemi çağrılarak Boolean.ToString oluşturulur.
Bu yöntem veya Boolean.TrueStringBoolean.FalseStringçıkışını alır.
Satır sonlandırıcı alanı tarafından CoreNewLine tanımlanır.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Ayrıca bkz.
- StreamWriter
- StringWriter
- Dosya ve Stream G/Ç
- Nasıl yapılır: Dosyadan Metin Okuma
- Nasıl yapılır: Bir Dosyaya Metin Yazma
Şunlara uygulanır
WriteLine()
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
Metin akışına bir satır sonlandırıcı yazar.
public:
virtual void WriteLine();
public virtual void WriteLine ();
abstract member WriteLine : unit -> unit
override this.WriteLine : unit -> unit
Public Overridable Sub WriteLine ()
Özel durumlar
Kapalı TextWriter .
Bir G/Ç hatası oluşur.
Açıklamalar
Satır sonlandırıcı alanı tarafından CoreNewLine tanımlanır.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Ayrıca bkz.
- StreamWriter
- StringWriter
- Dosya ve Stream G/Ç
- Nasıl yapılır: Dosyadan Metin Okuma
- Nasıl yapılır: Bir Dosyaya Metin Yazma
Şunlara uygulanır
WriteLine(ReadOnlySpan<Char>)
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
- Kaynak:
- TextWriter.cs
Bir karakter aralığının metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı yazar.
public:
virtual void WriteLine(ReadOnlySpan<char> buffer);
public virtual void WriteLine (ReadOnlySpan<char> buffer);
abstract member WriteLine : ReadOnlySpan<char> -> unit
override this.WriteLine : ReadOnlySpan<char> -> unit
Public Overridable Sub WriteLine (buffer As ReadOnlySpan(Of Char))
Parametreler
- buffer
- ReadOnlySpan<Char>
Metin akışına yazılacak char span değeri.
Açıklamalar
Belirtilen değerin metin gösterimi ReadOnlySpan<Karakteri> çağrılarak oluşturulur. ToString yöntemi.
Satır sonlandırıcı alanı tarafından CoreNewLine tanımlanır.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Şunlara uygulanır
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin