Bu makale, makine tarafından çevrilmiştir. Makaleyi İngilizce dilinde görüntülemek için İngilizce onay kutusunu işaretleyin. Ayrıca, fare işaretçisiyle İngilizce metnin üzerine gelerek metni açılır pencerede de görüntüleyebilirsiniz.
Çeviri
İngilizce

TextWriter.Write Yöntemi (String, Object)

 

Metin dizesi veya aynı semantiklere kullanarak akışına, biçimlendirilmiş bir dize Yazar String.Format(String, Object) yöntemi.

Ad alanı:   System.IO
Derleme:  mscorlib (mscorlib.dll içinde)

public virtual void Write(
	string format,
	object arg0
)

Parametreler

format
Type: System.String

Bir bileşik biçimlendirme dizesi (açıklamalar'a bakın).

arg0
Type: System.Object

Biçimlendirmek ve yazma için nesne.

Exception Condition
ArgumentNullException

format olan null.

ObjectDisposedException

TextWriter Kapalı.

IOException

G/ç hatası oluşur.

FormatException

format Geçerli bir bileşik biçim dizesi değil.

- veya -

Bir biçim öğesinin dizini 0 (sıfır), küçük veya büyük veya eşittir (olan, bu yöntem aşırı yüklemesi için) Biçimlendirilecek nesne sayısı.

Bu yöntem kullanan bir nesnenin değerini dize gösterimine dönüştürmek ve bu gösterimi bir dizeye katıştırmak için .NET Framework'ün. .NET Framework daha ayrıntılı olarak aşağıdaki biçimlendirme konularında açıklanan kapsamlı biçimlendirme desteği sağlar:

format Parametre sıfır veya bu yöntemin parametre listesindeki bir nesneye karşılık gelen, biçim öğeleri adı verilen sıfır veya daha fazla dizinli yer tutuculardan ile çalıştırmalar metin karışık. Biçimlendirme işlemi her biçim öğesini karşılık gelen nesne değerinin dize gösterimi ile değiştirir.

Bir biçim öğesinin sözdizimi aşağıdaki gibidir:

{dizini[,uzunluğu] [:formatString]}

Köşeli parantezlerdeki öğeler isteğe bağlıdır. Aşağıdaki tablo her öğeyi açıklar. Bileşik biçimlendirme özelliği, bir biçim öğesinin sözdizimi dahil olmak üzere hakkında daha fazla bilgi için bkz: Bileşik Biçimlendirme.

Öğe

Açıklama

index

Biçimlendirilecek nesnenin parametre listesinde sıfır tabanlı konum. Belirtilen nesne dizini olan null, biçim öğesi değiştirilir String.Empty. Bu aşırı kendi parametresinde yalnızca tek bir nesne olduğundan listesinde, değeri dizini her zaman 0 olmalıdır. Hiçbir parametre ise dizini konumu, bir FormatException oluşturulur.

,uzunluğu

En az sayıda karakteri dize gösterimine parametre. Pozitif ise sağa hizalı parametresidir; negatif ise sola hizalanır.

:formatString

Biçimlendirilecek nesne tarafından desteklenen standart veya özel bir biçim dizesi. Olası değerler için formatString nesnenin tarafından desteklenen değerleri aynı ToString(format) yöntemi. Varsa formatString belirtilmedi ve Biçimlendirilecek nesne uygulayan IFormattable arabirimi, null değeri olarak geçirilen format olarak kullanılan parametre IFormattable.ToString biçimlendirme dizesi.

Açılış ve kapanış ayraç karakterleri "{" ve "}" gereklidir. Bir tek değişmez değer küme ayracı karakteri belirtmek için format, iki satır aralığı belirtin veya sonda ayracı karakterleri; diğer bir deyişle, "{{" veya "}}".

. Bu yöntem değil tek tek bir yeni satır karakterleri (onaltılık 0x000a) için belirtilen dize arama ve bunlarla değiştirme TextWriter.NewLine.

Belirtilen bir nesnenin Biçim dizesinde başvurulmuyorsa, göz ardı edilir.

Ortak g/ç görevleri listesi için bkz: Ortak g-O görevler.

Evrensel Windows Platformu
10 sonrasında kullanılabilir
.NET Framework
1.1 sonrasında kullanılabilir
Silverlight
2.0 sonrasında kullanılabilir
Windows Phone Silverlight
7.0 sonrasında kullanılabilir
Başa dön
Show: