TextWriter.Write Yöntem

Başvuru

Tanım

Ad Alanı:: System.IO

Bütünleştirilmiş Kod:: System.IO.dll

Bütünleştirilmiş Kod:: System.Runtime.dll

Bütünleştirilmiş Kod:: System.Runtime.Extensions.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.dll

Ö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.

Aşırı Yüklemeler

Write(String, Object, Object, Object)	Format(String, Object, Object, Object) yöntemiyle aynı semantiği kullanarak metin akışına biçimlendirilmiş bir dize yazar.
Write(Char[], Int32, Int32)	Metin akışına karakterlerin alt dizisini yazar.
Write(String, ReadOnlySpan<Object>)	Format(String, ReadOnlySpan<Object>)ile aynı semantiği kullanarak metin akışına biçimlendirilmiş bir dize yazar.
Write(String, Object[])	Format(String, Object[]) yöntemiyle aynı semantiği kullanarak metin akışına biçimlendirilmiş bir dize yazar.
Write(String, Object)	Format(String, Object) yöntemiyle aynı semantiği kullanarak metin akışına biçimlendirilmiş bir dize yazar.
Write(UInt64)	8 baytlık işaretsiz tamsayının metin gösterimini metin akışına yazar.
Write(UInt32)	4 baytlık işaretsiz tamsayının metin gösterimini metin akışına yazar.
Write(StringBuilder)	Metin akışına bir dize oluşturucu yazar.
Write(String)	Metin akışına bir dize yazar.
Write(Single)	4 baytlık kayan nokta değerinin metin gösterimini metin akışına yazar.
Write(String, Object, Object)	Format(String, Object, Object) yöntemiyle aynı semantiği kullanarak metin akışına biçimlendirilmiş bir dize yazar.
Write(Object)	Nesne üzerinde `ToString` yöntemini çağırarak bir nesnenin metin gösterimini metin akışına yazar.
Write(Int64)	8 baytlık imzalı tamsayının metin gösterimini metin akışına yazar.
Write(Int32)	4 baytlık imzalı tamsayının metin gösterimini metin akışına yazar.
Write(Double)	8 baytlık kayan nokta değerinin metin gösterimini metin akışına yazar.
Write(Decimal)	Ondalık değerin metin gösterimini metin akışına yazar.
Write(Char[])	Metin akışına bir karakter dizisi yazar.
Write(Char)	Metin akışına bir karakter yazar.
Write(Boolean)	Bir `Boolean` değerinin metin gösterimini metin akışına yazar.
Write(ReadOnlySpan<Char>)	Metin akışına bir karakter aralığı yazar.

Write(String, Object, Object, Object)

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Format(String, Object, Object, Object) yöntemiyle aynı semantiği kullanarak metin akışına biçimlendirilmiş bir dize yazar.

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);

public virtual void Write (string format, object arg0, object arg1, object arg2);

public virtual void Write (string format, object? arg0, object? arg1, object? arg2);

abstract member Write : string * obj * obj * obj -> unit
override this.Write : string * obj * obj * obj -> unit

Public Overridable Sub Write (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

ArgumentNullException

format null.

ObjectDisposedException

TextWriter kapatıldı.

IOException

G/Ç hatası oluşur.

FormatException

format geçerli bir bileşik biçim dizesi değildir.

-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 üç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 Dizeleri ve Özel Tarih ve Saat Biçim 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.

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 dize gösterimiyle değiştirir.

Biçim öğesinin söz dizimi aşağıdaki gibidir:

{dizin[,uzunluk][:formatString]}

Köşeli ayraç içindeki öğeler isteğe bağlıdır. Aşağıdaki tabloda her öğe açıklanmaktadır. 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 `null`ise, biçim öğesi String.Emptyile değiştirilir. Bu aşırı yüklemenin parametre listesinde üç nesnesi olduğundan, dizin değeri her zaman 0, 1 veya 2 olmalıdır. dizini konumunda parametre yoksa, bir FormatException oluşturulur.
,uzunluk	Parametresinin 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 IFormattable arabirimini uygularsa, `null`IFormattable.ToString biçim dizesi olarak kullanılan `format` parametresinin değeri olarak geçirilir.

"{" ve "}" baştaki ve sondaki ayraç karakterleri gereklidir. formatiçinde 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ı TextWriter.NewLineile değiştirmez.

Belirtilen bir nesneye biçim dizesinde başvurulmazsa, yoksayılır.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

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.5, 1.6, 2.0, 2.1
UWP	10.0

Write(Char[], Int32, Int32)

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Metin akışına karakterlerin alt dizisini yazar.

public:
 virtual void Write(cli::array <char> ^ buffer, int index, int count);

public virtual void Write (char[] buffer, int index, int count);

abstract member Write : char[] * int * int -> unit
override this.Write : char[] * int * int -> unit

Public Overridable Sub Write (buffer As Char(), index As Integer, count As Integer)

Parametreler

buffer: Char[]

Veri yazacak karakter dizisi.

index: Int32

Arabellekte veri almaya başlanması gereken karakter konumu.

count: Int32

Yazacak karakter sayısı.

Özel durumlar

ArgumentException

Arabellek uzunluğu eksi indexcount'den küçüktür.

ArgumentNullException

buffer parametresi null.

ArgumentOutOfRangeException

index veya count negatiftir.

ObjectDisposedException

TextWriter kapatıldı.

IOException

G/Ç hatası oluşur.

Açıklamalar

Bu yöntem, indexkonumundan başlayarak buffer karakter dizisinden bu TextWriter verilerin count karakterlerini yazar.

Bu aşırı yükleme, index ile (index + count) arasındaki buffer her karakter için Write(Char[]) aşırı yüklemesine eşdeğerdir.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

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.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(String, ReadOnlySpan<Object>)

Format(String, ReadOnlySpan<Object>)ile aynı semantiği kullanarak metin akışına biçimlendirilmiş bir dize yazar.

public:
 virtual void Write(System::String ^ format, ReadOnlySpan<System::Object ^> arg);

public virtual void Write (string format, scoped ReadOnlySpan<object?> arg);

abstract member Write : string * ReadOnlySpan<obj> -> unit
override this.Write : string * ReadOnlySpan<obj> -> unit

Public Overridable Sub Write (format As String, arg As ReadOnlySpan(Of Object))

Parametreler

format: String

Bileşik biçim dizesi.

arg: ReadOnlySpan<Object>

Biçimlendirilip yazılacak sıfır veya daha fazla nesne içeren nesne aralığı.

Şunlara uygulanır

.NET 9

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

Write(String, Object[])

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Format(String, Object[]) yöntemiyle aynı semantiği kullanarak metin akışına biçimlendirilmiş bir dize yazar.

public:
 virtual void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);

public virtual void Write (string format, params object[] arg);

public virtual void Write (string format, params object?[] arg);

abstract member Write : string * obj[] -> unit
override this.Write : string * obj[] -> unit

Public Overridable Sub Write (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

ArgumentNullException

format veya argnull.

ObjectDisposedException

TextWriter kapatıldı.

IOException

G/Ç hatası oluşur.

FormatException

format geçerli bir bileşik biçim dizesi değildir.

-veya-

Biçim öğesinin dizini 0'dan küçük (sıfır) veya arg dizisinin uzunluğundan büyük veya buna eşit.

Açıklamalar

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 Dizeleri ve Özel Tarih ve Saat Biçim 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.

Biçim öğesinin söz dizimi aşağıdaki gibidir:

{dizin[,uzunluk][:formatString]}

Öğe	Açıklama
Dizin	Biçimlendirilecek nesnenin parametre listesindeki sıfır tabanlı konum. dizin tarafından belirtilen nesne `null`ise, biçim öğesi String.Emptyile değiştirilir. Bu aşırı yüklemenin parametre listesinde bir dizi olduğundan, dizin değeri her zaman dizinin uzunluğundan küçük olmalıdır. dizini konumunda parametre yoksa, bir FormatException oluşturulur.
,uzunluk	Parametresinin 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 IFormattable arabirimini uygularsa, `null`IFormattable.ToString biçim dizesi olarak kullanılan `format` parametresinin değeri olarak geçirilir.

Bu yöntem belirtilen dizede tek tek yeni satır karakterleri (onaltılık 0x000a) aramaz ve bunları TextWriter.NewLineile değiştirmez.

Belirtilen bir nesneye biçim dizesinde başvurulmazsa, yoksayılır.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

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.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(String, Object)

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Format(String, Object) yöntemiyle aynı semantiği kullanarak metin akışına biçimlendirilmiş bir dize yazar.

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0);

public virtual void Write (string format, object arg0);

public virtual void Write (string format, object? arg0);

abstract member Write : string * obj -> unit
override this.Write : string * obj -> unit

Public Overridable Sub Write (format As String, arg0 As Object)

Parametreler

format: String

Bileşik biçim dizesi.

arg0: Object

Biçimlendirilip yazacak nesne.

Özel durumlar

ArgumentNullException

format null.

ObjectDisposedException

TextWriter kapatıldı.

IOException

G/Ç hatası oluşur.

FormatException

format geçerli bir bileşik biçim dizesi değildir.

-veya-

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 birdir).

Açıklamalar

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 Dizeleri ve Özel Tarih ve Saat Biçim 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.

Biçim öğesinin söz dizimi aşağıdaki gibidir:

{dizin[,uzunluk][:formatString]}

Öğe	Açıklama
Dizin	Biçimlendirilecek nesnenin parametre listesindeki sıfır tabanlı konum. dizin tarafından belirtilen nesne `null`ise, biçim öğesi String.Emptyile değiştirilir. Bu aşırı yüklemenin parametre listesinde yalnızca tek bir nesnesi olduğundan, dizin değeri her zaman 0 olmalıdır. dizini konumunda parametre yoksa, bir FormatException oluşturulur.
,uzunluk	Parametresinin 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 IFormattable arabirimini uygularsa, `null`IFormattable.ToString biçim dizesi olarak kullanılan `format` parametresinin değeri olarak geçirilir.

Bu yöntem belirtilen dizede tek tek yeni satır karakterleri (onaltılık 0x000a) aramaz ve bunları TextWriter.NewLineile değiştirmez.

Belirtilen bir nesneye biçim dizesinde başvurulmazsa, yoksayılır.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

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.5, 1.6, 2.0, 2.1
UWP	10.0

Write(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.

public:
 virtual void Write(System::UInt64 value);

[System.CLSCompliant(false)]
public virtual void Write (ulong value);

[<System.CLSCompliant(false)>]
abstract member Write : uint64 -> unit
override this.Write : uint64 -> unit

Public Overridable Sub Write (value As ULong)

Parametreler

value: UInt64

Yazacak 8 baytlık işaretsiz tamsayı.

Öznitelikler: CLSCompliantAttribute

Özel durumlar

ObjectDisposedException

TextWriter kapatıldı.

IOException

G/Ç hatası oluşur.

Açıklamalar

Belirtilen değerin metin gösterimi, UInt64.ToString yöntemi çağrılarak oluşturulur. nulldeğilse TextWriter.FormatProvider özelliği kültüre özgü biçimlendirmeyi belirtir.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

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.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(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.

public:
 virtual void Write(System::UInt32 value);

[System.CLSCompliant(false)]
public virtual void Write (uint value);

[<System.CLSCompliant(false)>]
abstract member Write : uint32 -> unit
override this.Write : uint32 -> unit

Public Overridable Sub Write (value As UInteger)

Parametreler

value: UInt32

Yazacak 4 baytlık işaretsiz tamsayı.

Öznitelikler: CLSCompliantAttribute

Özel durumlar

ObjectDisposedException

TextWriter kapatıldı.

IOException

G/Ç hatası oluşur.

Açıklamalar

Belirtilen değerin metin gösterimi, UInt32.ToString yöntemi çağrılarak oluşturulur. nulldeğilse TextWriter.FormatProvider özelliği kültüre özgü biçimlendirmeyi belirtir.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

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.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(StringBuilder)

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Metin akışına bir dize oluşturucu yazar.

public:
 virtual void Write(System::Text::StringBuilder ^ value);

public virtual void Write (System.Text.StringBuilder? value);

abstract member Write : System.Text.StringBuilder -> unit
override this.Write : System.Text.StringBuilder -> unit

Public Overridable Sub Write (value As StringBuilder)

Parametreler

value: StringBuilder

Metin akışına yazmak için dize oluşturucusu olarak dize.

Açıklamalar

Bu yöntem Write(stringBuilder.ToString())eşdeğerdir, ancak ara dizeyi oluşturmaktan kaçınmak için StringBuilder.GetChunks yöntemini kullanır.

Şunlara uygulanır

.NET 9 ve diğer sürümler

Ürün	Sürümler
.NET	Core 3.0, Core 3.1, 5, 6, 7, 8, 9

Write(String)

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Metin akışına bir dize yazar.

public:
 virtual void Write(System::String ^ value);

public virtual void Write (string value);

public virtual void Write (string? value);

abstract member Write : string -> unit
override this.Write : string -> unit

Public Overridable Sub Write (value As String)

Parametreler

value: String

Yazacak dize.

Özel durumlar

ObjectDisposedException

TextWriter kapatıldı.

IOException

G/Ç hatası oluşur.

Açıklamalar

Bu aşırı yükleme, Write(Char[]) aşırı yüklemesine eşdeğerdir.

Bu yöntem belirtilen dizede tek tek yeni satır karakterleri (onaltılık 0x000a) aramaz ve bunları TextWriter.NewLineile değiştirmez.

value nullise, metin akışına hiçbir şey yazılır.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

Ayrıca bkz.

Write(String)
Write(String)
Dosya ve Akış G/Ç
Nasıl yapılır: Dosya Metin Okuma
Nasıl yapılır: Dosya Metin Yazma

Ş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.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(Single)

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

4 baytlık kayan nokta değerinin metin gösterimini metin akışına yazar.

public:
 virtual void Write(float value);

public virtual void Write (float value);

abstract member Write : single -> unit
override this.Write : single -> unit

Public Overridable Sub Write (value As Single)

Parametreler

value: Single

Yazacak 4 baytlık kayan nokta değeri.

Özel durumlar

ObjectDisposedException

TextWriter kapatıldı.

IOException

G/Ç hatası oluşur.

Açıklamalar

Belirtilen değerin metin gösterimi, Single.ToString yöntemi çağrılarak oluşturulur. nulldeğilse TextWriter.FormatProvider özelliği kültüre özgü biçimlendirmeyi belirtir.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

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.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(String, Object, Object)

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Format(String, Object, Object) yöntemiyle aynı semantiği kullanarak metin akışına biçimlendirilmiş bir dize yazar.

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);

public virtual void Write (string format, object arg0, object arg1);

public virtual void Write (string format, object? arg0, object? arg1);

abstract member Write : string * obj * obj -> unit
override this.Write : string * obj * obj -> unit

Public Overridable Sub Write (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

ArgumentNullException

format null.

ObjectDisposedException

TextWriter kapatıldı.

IOException

G/Ç hatası oluşur.

FormatException

format geçerli bir bileşik biçim dizesi değildir.

-veya-

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 ikidir).

Açıklamalar

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 Dizeleri ve Özel Tarih ve Saat Biçim 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.

Biçim öğesinin söz dizimi aşağıdaki gibidir:

{dizin[,uzunluk][:formatString]}

Öğe	Açıklama
Dizin	Biçimlendirilecek nesnenin parametre listesindeki sıfır tabanlı konum. dizin tarafından belirtilen nesne `null`ise, biçim öğesi String.Emptyile değiştirilir. Bu aşırı yüklemenin parametre listesinde iki nesnesi olduğundan, dizin değeri her zaman 0 veya 1 olmalıdır. dizini konumunda parametre yoksa, bir FormatException oluşturulur.
,uzunluk	Parametresinin 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 IFormattable arabirimini uygularsa, `null`IFormattable.ToString biçim dizesi olarak kullanılan `format` parametresinin değeri olarak geçirilir.

Bu yöntem belirtilen dizede tek tek yeni satır karakterleri (onaltılık 0x000a) aramaz ve bunları TextWriter.NewLineile değiştirmez.

Belirtilen bir nesneye biçim dizesinde başvurulmazsa, yoksayılır.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

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.5, 1.6, 2.0, 2.1
UWP	10.0

Write(Object)

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Nesne üzerinde ToString yöntemini çağırarak bir nesnenin metin gösterimini metin akışına yazar.

public:
 virtual void Write(System::Object ^ value);

public virtual void Write (object value);

public virtual void Write (object? value);

abstract member Write : obj -> unit
override this.Write : obj -> unit

Public Overridable Sub Write (value As Object)

Parametreler

value: Object

Yazacak nesne.

Özel durumlar

ObjectDisposedException

TextWriter kapatıldı.

IOException

G/Ç hatası oluşur.

Açıklamalar

Bu aşırı yükleme, Write(String) aşırı yüklemesine eşdeğerdir.

Belirtilen nesne nullise hiçbir işlem yapılmaz ve özel durum oluşturmaz. Aksi takdirde, dize gösterimini oluşturmak için nesnenin ToString yöntemi çağrılır ve sonuçta elde edilen dize çıkış akışına yazılır. nulldeğilse FormatProvider özelliği kültüre özgü biçimlendirmeyi belirtir.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

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.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(Int64)

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

8 baytlık imzalı tamsayının metin gösterimini metin akışına yazar.

public:
 virtual void Write(long value);

public virtual void Write (long value);

abstract member Write : int64 -> unit
override this.Write : int64 -> unit

Public Overridable Sub Write (value As Long)

Parametreler

value: Int64

Yazacak 8 baytlık imzalı tamsayı.

Özel durumlar

ObjectDisposedException

TextWriter kapatıldı.

IOException

G/Ç hatası oluşur.

Açıklamalar

Belirtilen değerin metin gösterimi, Int64.ToString yöntemi çağrılarak oluşturulur. nulldeğilse TextWriter.FormatProvider özelliği kültüre özgü biçimlendirmeyi belirtir.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

Nasıl yapılır: Dosya Metin Yazma

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.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(Int32)

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

4 baytlık imzalı tamsayının metin gösterimini metin akışına yazar.

public:
 virtual void Write(int value);

public virtual void Write (int value);

abstract member Write : int -> unit
override this.Write : int -> unit

Public Overridable Sub Write (value As Integer)

Parametreler

value: Int32

Yazacak 4 baytlık imzalı tamsayı.

Özel durumlar

ObjectDisposedException

TextWriter kapatıldı.

IOException

G/Ç hatası oluşur.

Açıklamalar

Belirtilen değerin metin gösterimi, Int32.ToString yöntemi çağrılarak oluşturulur. nulldeğilse TextWriter.FormatProvider özelliği kültüre özgü biçimlendirmeyi belirtir.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

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.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(Double)

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

8 baytlık kayan nokta değerinin metin gösterimini metin akışına yazar.

public:
 virtual void Write(double value);

public virtual void Write (double value);

abstract member Write : double -> unit
override this.Write : double -> unit

Public Overridable Sub Write (value As Double)

Parametreler

value: Double

Yazacak 8 baytlık kayan nokta değeri.

Özel durumlar

ObjectDisposedException

TextWriter kapatıldı.

IOException

G/Ç hatası oluşur.

Açıklamalar

Belirtilen değerin metin gösterimi, Double.ToString yöntemi çağrılarak oluşturulur. nulldeğilse TextWriter.FormatProvider özelliği kültüre özgü biçimlendirmeyi belirtir.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

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.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(Decimal)

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Ondalık değerin metin gösterimini metin akışına yazar.

public:
 virtual void Write(System::Decimal value);

public virtual void Write (decimal value);

abstract member Write : decimal -> unit
override this.Write : decimal -> unit

Public Overridable Sub Write (value As Decimal)

Parametreler

value: Decimal

Yazacak ondalık değer.

Özel durumlar

ObjectDisposedException

TextWriter kapatıldı.

IOException

G/Ç hatası oluşur.

Açıklamalar

nulldeğilse FormatProvider özelliği kültüre özgü biçimlendirmeyi belirtir.

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.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(Char[])

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Metin akışına bir karakter dizisi yazar.

public:
 virtual void Write(cli::array <char> ^ buffer);

public virtual void Write (char[] buffer);

public virtual void Write (char[]? buffer);

abstract member Write : char[] -> unit
override this.Write : char[] -> unit

Public Overridable Sub Write (buffer As Char())

Parametreler

buffer: Char[]

Metin akışına yazacak karakter dizisi.

Özel durumlar

ObjectDisposedException

TextWriter kapatıldı.

IOException

G/Ç hatası oluşur.

Açıklamalar

Bu yöntem belirtilen dizede tek tek yeni satır karakterleri (onaltılık 0x000a) aramaz ve bunları NewLineile değiştirmez.

Bu varsayılan yöntem Write(Char[], Int32, Int32) yöntemini çağırır ve karakter dizisinin tamamını geçirir. Karakter dizisi nullise hiçbir şey yazılır.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

Ayrıca bkz.

Write(Char[])
Dosya ve Akış G/Ç
Nasıl yapılır: Dosya Metin Okuma
Nasıl yapılır: Dosya Metin Yazma

Ş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.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(Char)

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Metin akışına bir karakter yazar.

public:
 abstract void Write(char value);

public:
 virtual void Write(char value);

public abstract void Write (char value);

public virtual void Write (char value);

abstract member Write : char -> unit

abstract member Write : char -> unit
override this.Write : char -> unit

Public MustOverride Sub Write (value As Char)

Public Overridable Sub Write (value As Char)

Parametreler

value: Char

Metin akışına yazacak karakter.

Özel durumlar

ObjectDisposedException

TextWriter kapatıldı.

IOException

G/Ç hatası oluşur.

Açıklamalar

Bu varsayılan yöntem hiçbir şey yapmaz, ancak türetilmiş sınıflar uygun işlevselliği sağlamak için yöntemini geçersiz kılabilir.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

Ayrıca bkz.

Write(Char)
Write(Char)
Dosya ve Akış G/Ç
Nasıl yapılır: Dosya Metin Okuma
Nasıl yapılır: Dosya Metin Yazma

Ş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.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(Boolean)

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Bir Boolean değerinin metin gösterimini metin akışına yazar.

public:
 virtual void Write(bool value);

public virtual void Write (bool value);

abstract member Write : bool -> unit
override this.Write : bool -> unit

Public Overridable Sub Write (value As Boolean)

Parametreler

value: Boolean

Yazacak Boolean değeri.

Özel durumlar

ObjectDisposedException

TextWriter kapatıldı.

IOException

G/Ç hatası oluşur.

Açıklamalar

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

Bu yöntem Boolean.TrueString veya Boolean.FalseStringçıkışını oluşturur.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

Ayrıca bkz.

StreamWriter
StringWriter
Dosya ve Akış G/Ç
Nasıl yapılır: Dosya Metin Okuma
Nasıl yapılır: Dosya Metin Yazma

Ş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.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(ReadOnlySpan<Char>)

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Kaynak:: TextWriter.cs

Metin akışına bir karakter aralığı yazar.

public:
 virtual void Write(ReadOnlySpan<char> buffer);

public virtual void Write (ReadOnlySpan<char> buffer);

abstract member Write : ReadOnlySpan<char> -> unit
override this.Write : ReadOnlySpan<char> -> unit

Public Overridable Sub Write (buffer As ReadOnlySpan(Of Char))

Parametreler

buffer: ReadOnlySpan<Char>

Yazılacak karakter aralığı.

Açıklamalar

Belirtilen değerin metin gösterimi, ReadOnlySpan<Char>çağrılarak oluşturulur. ToString yöntemi.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

Şunlara uygulanır

.NET 9 ve diğer sürümler

Ürün	Sürümler
.NET	Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard	2.1

Aracılığıyla paylaş

TextWriter.Write Yöntem

Tanım

Aşırı Yüklemeler

Write(String, Object, Object, Object)

Parametreler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Write(Char[], Int32, Int32)

Parametreler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Write(String, ReadOnlySpan<Object>)

Parametreler

Şunlara uygulanır

Write(String, Object[])

Parametreler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Write(String, Object)

Parametreler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Write(UInt64)

Parametreler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Write(UInt32)

Parametreler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Write(StringBuilder)

Parametreler

Açıklamalar

Şunlara uygulanır

Write(String)

Parametreler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Write(Single)

Parametreler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Write(String, Object, Object)

Parametreler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Write(Object)

Parametreler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Write(Int64)

Parametreler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Write(Int32)

Parametreler

Özel durumlar