String.Format Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Nesnelerin değerini belirtilen biçimlere göre dizelere dönüştürür ve bunları başka bir dizeye ekler.

Yöntemi kullanmaya String.Format yeni başladıysanız, hızlı bir genel bakış için bkz. String.Format yöntemini kullanmaya başlama .

Aşırı Yüklemeler

Name	Description
Format(IFormatProvider, String, Object, Object, Object)	Bir dizedeki biçim öğelerini belirtilen üç nesnenin dize gösterimiyle değiştirir. Parametre kültüre özgü biçimlendirme bilgileri sağlar.
Format(IFormatProvider, String, Object, Object)	Bir dizedeki biçim öğelerini belirtilen iki nesnenin dize gösterimiyle değiştirir. Parametre kültüre özgü biçimlendirme bilgileri sağlar.
Format(String, Object, Object)	Bir dizedeki biçim öğelerini belirtilen iki nesnenin dize gösterimiyle değiştirir.
Format(IFormatProvider, CompositeFormat, ReadOnlySpan<Object>)	içindeki biçim öğesini veya öğelerini CompositeFormat , belirtilen biçimde karşılık gelen nesnelerin dize gösterimiyle değiştirir.
Format(IFormatProvider, CompositeFormat, Object[])	içindeki biçim öğesini veya öğelerini CompositeFormat , belirtilen biçimde karşılık gelen nesnelerin dize gösterimiyle değiştirir.
Format(String, Object, Object, Object)	Bir dizedeki biçim öğelerini belirtilen üç nesnenin dize gösterimiyle değiştirir.
Format(IFormatProvider, String, Object[])	Bir dizedeki biçim öğelerini, belirtilen dizideki ilgili nesnelerin dize gösterimleriyle değiştirir. Parametre kültüre özgü biçimlendirme bilgileri sağlar.
Format(IFormatProvider, String, Object)	Belirtilen dizedeki biçim öğesini veya öğelerini ilgili nesnenin dize gösterimiyle değiştirir. Parametre kültüre özgü biçimlendirme bilgileri sağlar.
Format(String, ReadOnlySpan<Object>)	Belirtilen dizedeki biçim öğesini, belirtilen bir yayılma alanında karşılık gelen bir nesnenin dize gösterimiyle değiştirir.
Format(String, Object[])	Belirtilen dizedeki biçim öğesini, belirtilen dizideki karşılık gelen bir nesnenin dize gösterimiyle değiştirir.
Format(String, Object)	Bir dizedeki bir veya daha fazla biçim öğesini belirtilen nesnenin dize gösterimiyle değiştirir.
Format(IFormatProvider, String, ReadOnlySpan<Object>)	Bir dizedeki biçim öğelerini, belirtilen bir yayılma alanında karşılık gelen nesnelerin dize gösterimleriyle değiştirir. Parametre kültüre özgü biçimlendirme bilgileri sağlar.
Format<TArg0,TArg1,TArg2>(IFormatProvider, CompositeFormat, TArg0, TArg1, TArg2)	içindeki biçim öğesini veya öğelerini CompositeFormat , belirtilen biçimde karşılık gelen nesnelerin dize gösterimiyle değiştirir.
Format<TArg0,TArg1>(IFormatProvider, CompositeFormat, TArg0, TArg1)	içindeki biçim öğesini veya öğelerini CompositeFormat , belirtilen biçimde karşılık gelen nesnelerin dize gösterimiyle değiştirir.
Format<TArg0>(IFormatProvider, CompositeFormat, TArg0)	içindeki biçim öğesini veya öğelerini CompositeFormat , belirtilen biçimde karşılık gelen nesnelerin dize gösterimiyle değiştirir.

Örnekler

Makale boyunca Format yöntemini çağıran çok sayıda örnek serpiştirilmiştir. String.Format içeren eksiksiz bir örnek kümesini de indirebilirsiniz.

Makaledeki örneklerden bazıları şunlardır:

Biçim dizesi oluşturma

Dize ekleme
Biçim öğesi
Aynı dizine sahip öğeleri biçimlendirme

Denetim biçimlendirilmiş çıktı

Biçimlendirmeyi denetleme
Denetim aralığı
Hizalamayı denetleme
İntegral basamak sayısını denetleme
Ondalık ayırıcıdan sonraki basamak sayısını denetleme
Sonuç dizesine küme parantezlerini dahil et

Biçim dizelerini kültüre duyarlı hale getirme

Biçim dizelerini kültüre duyarlı hale getirme

Biçimlendirme işlemini özelleştirme

Özel biçimlendirme işlemi
Kesme noktası sağlayıcısı ve Roma rakamı biçimlendiricisi

String.Format yöntemini kullanmaya başlama

Bir nesnenin, değişkenin veya ifadenin değerini başka bir dizeye eklemeniz gerekiyorsa kullanın String.Format . Örneğin, bir Decimal değerin değerini bir dizeye ekleyerek kullanıcıya tek bir dize olarak görüntüleyebilirsiniz:

Decimal pricePerOunce = 17.36m;
String s = String.Format("The current price is {0} per ounce.",
                         pricePerOunce);
Console.WriteLine(s);
// Result: The current price is 17.36 per ounce.

let pricePerOunce = 17.36m
String.Format("The current price is {0} per ounce.", pricePerOunce)
|> printfn "%s"
// Result: The current price is 17.36 per ounce.

Dim pricePerOunce As Decimal = 17.36D
Dim s As String = String.Format("The current price is {0} per ounce.",
                              pricePerOunce)
' Result: The current price is 17.36 per ounce.

Ayrıca bu değerin biçimlendirmesini denetleyebilirsiniz:

Decimal pricePerOunce = 17.36m;
String s = String.Format("The current price is {0:C2} per ounce.",
                         pricePerOunce);
Console.WriteLine(s);
// Result if current culture is en-US:
//      The current price is $17.36 per ounce.

let pricePerOunce = 17.36m
String.Format("The current price is {0:C2} per ounce.", pricePerOunce)
|> printfn "%s"
// Result if current culture is en-US:
//      The current price is $17.36 per ounce.

Dim pricePerOunce As Decimal = 17.36D
Dim s As String = String.Format("The current price is {0:C2} per ounce.",
                              pricePerOunce)
' Result if current culture is en-US:
'      The current price is $17.36 per ounce.

Biçimlendirmenin yanı sıra hizalamayı ve aralığı da denetleyebilirsiniz.

Bir dize ekleyin

String.Format bir biçim dizesiyle başlar ve ardından dizelere dönüştürülecek ve biçim dizesinde belirtilen bir yere eklenecek bir veya daha fazla nesne veya ifade içerir. Örneğin:

decimal temp = 20.4m;
string s = String.Format("The temperature is {0}°C.", temp);
Console.WriteLine(s);
// Displays 'The temperature is 20.4°C.'

let temp = 20.4m
String.Format("The temperature is {0}°C.", temp)
|> printfn "%s"
// Displays 'The temperature is 20.4°C.'

Dim temp As Decimal = 20.4D
Dim s As String = String.Format("The temperature is {0}°C.", temp)
Console.WriteLine(s)
' Displays 'The temperature is 20.4°C.'

{0} biçim dizesindeki bir biçim öğesidir. 0 , dize değeri bu konuma eklenecek nesnenin dizinidir. (Dizinler 0'da başlar.) Eklenecek nesne bir dize değilse, ToString sonuç dizesine eklemeden önce bir nesneye dönüştürmek için yöntemi çağrılır.

Burada, nesne listesinde iki biçim öğesi ve iki nesne kullanan başka bir örnek verilmiştir:

string s = String.Format("At {0}, the temperature is {1}°C.",
                         DateTime.Now, 20.4);
Console.WriteLine(s);
// Output similar to: 'At 4/10/2015 9:29:41 AM, the temperature is 20.4°C.'

String.Format("At {0}, the temperature is {1}°C.", DateTime.Now, 20.4)
|> printfn "%s"
// Output similar to: 'At 4/10/2015 9:29:41 AM, the temperature is 20.4°C.'

Dim s As String = String.Format("At {0}, the temperature is {1}°C.",
                              Date.Now, 20.4)
' Output similar to: 'At 4/10/2015 9:29:41 AM, the temperature is 20.4°C.'

Her biçim öğesinin dizininde nesne listesinde eşleşen bir nesne olduğu sürece nesne listesinde istediğiniz kadar biçim öğesi ve nesne olabilir. Hangi aşırı yüklemeyi çağıracağınız konusunda endişelenmenize gerek yok; derleyici sizin için uygun olanı seçer.

Biçimlendirmeyi denetleme

Bir nesnenin nasıl biçimlendirildiğini denetlemek için bir biçim dizesi içeren bir biçim öğesinde dizini izleyebilirsiniz. Örneğin, {0:d} "d" biçim dizesini nesne listesindeki ilk nesneye uygular. Tek bir nesne ve iki biçim öğesi içeren bir örnek aşağıda verilmiştir:

string s = String.Format("It is now {0:d} at {0:t}", DateTime.Now);
Console.WriteLine(s);
// Output similar to: 'It is now 4/10/2015 at 10:04 AM'

String.Format("It is now {0:d} at {0:t}", DateTime.Now)
|> printfn "%s"
// Output similar to: 'It is now 4/10/2015 at 10:04 AM'

Dim s As String = String.Format("It is now {0:d} at {0:t}",
                              Date.Now)
' Output similar to: 'It is now 4/10/2015 at 10:04 AM'

Çok sayıda tür, tüm sayısal türler (hem standart hem de özel biçim dizeleri), tüm tarih ve saatler (hem standart hem de özel biçim dizeleri) ve zaman aralıkları (hem standart hem de özel biçim dizeleri), tüm numaralandırma türleri numaralandırma türleri ve GUID'ler dahil olmak üzere biçim dizelerini destekler. Kendi türlerinize biçim dizeleri için destek de ekleyebilirsiniz.

Denetim aralığı

12 karakterlik bir dize ekleyen gibi {0,12}bir söz dizimi kullanarak sonuç dizesine eklenen dizenin genişliğini tanımlayabilirsiniz. Bu durumda, ilk nesnenin dize gösterimi 12 karakterlik alanda sağa hizalanır. (İlk nesnenin dize gösterimi 12 karakterden uzunsa, tercih edilen alan genişliği yoksayılır ve dizenin tamamı sonuç dizesine eklenir.)

Aşağıdaki örnek, "Year" dizesini ve bazı yıl dizelerini tutan 6 karakterlik bir alanın yanı sıra "Population" dizesini ve bazı popülasyon verilerini tutan 15 karakterlik bir alanı tanımlar. Karakterlerin alanda sağa hizalandığını unutmayın.

int[] years = { 2013, 2014, 2015 };
int[] population = { 1025632, 1105967, 1148203 };
var sb = new System.Text.StringBuilder();
sb.Append(String.Format("{0,6} {1,15}\n\n", "Year", "Population"));
for (int index = 0; index < years.Length; index++)
    sb.Append(String.Format("{0,6} {1,15:N0}\n", years[index], population[index]));

Console.WriteLine(sb);

// Result:
//      Year      Population
//
//      2013       1,025,632
//      2014       1,105,967
//      2015       1,148,203

open System
open System.Text
 
let years = [| 2013; 2014; 2015 |]
let population = [| 1025632; 1105967; 1148203 |]
let sb = StringBuilder()
sb.Append(String.Format("{0,6} {1,15}\n\n", "Year", "Population")) |> ignore
for i = 0 to years.Length - 1 do
   sb.Append(String.Format("{0,6} {1,15:N0}\n", years[i], population[i])) |> ignore

printfn $"{sb}"

// Result:
//      Year      Population
//
//      2013       1,025,632
//      2014       1,105,967
//      2015       1,148,203

Dim years() As Integer = {2013, 2014, 2015}
Dim population() As Integer = {1025632, 1105967, 1148203}
Dim sb As New StringBuilder()
sb.Append(String.Format("{0,6} {1,15}{2}{2}",
                       "Year", "Population", vbCrLf))
For index As Integer = 0 To years.Length - 1
    sb.AppendFormat("{0,6} {1,15:N0}{2}",
                  years(index), population(index), vbCrLf)
Next
' Result:
'      Year      Population
'
'      2013       1,025,632
'      2014       1,105,967
'      2015       1,148,203

Hizalamayı denetleme

Varsayılan olarak, bir alan genişliği belirtirseniz, dizeler alanları içinde sağa hizalanır. Bir alandaki dizeleri sola hizalamak için, alan genişliğinin önüne negatif bir işaret koyarsınız, bu da 12 karakter sola hizalanmış bir alan tanımlamak gibi {0,-12}.

Aşağıdaki örnek, hem etiketleri hem de verileri sola hizalaması dışında öncekine benzer.

int[] years = { 2013, 2014, 2015 };
int[] population = { 1025632, 1105967, 1148203 };
String s = String.Format("{0,-10} {1,-10}\n\n", "Year", "Population");
for (int index = 0; index < years.Length; index++)
    s += String.Format("{0,-10} {1,-10:N0}\n",
                       years[index], population[index]);
Console.WriteLine($"\n{s}");
// Result:
//    Year       Population
//
//    2013       1,025,632
//    2014       1,105,967
//    2015       1,148,203

let years = [| 2013; 2014; 2015 |]
let population = [| 1025632; 1105967; 1148203 |]
let mutable s = String.Format("{0,-10} {1,-10}\n\n", "Year", "Population")
for i = 0 to years.Length - 1 do
    s <- s + String.Format("{0,-10} {1,-10:N0}\n", years[i], population[i])
printfn $"\n{s}"
// Result:
//    Year       Population
//
//    2013       1,025,632
//    2014       1,105,967
//    2015       1,148,203

Dim years() As Integer = {2013, 2014, 2015}
Dim population() As Integer = {1025632, 1105967, 1148203}
Dim s As String = String.Format("{0,-10} {1,-10}{2}{2}",
                               "Year", "Population", vbCrLf)
For index As Integer = 0 To years.Length - 1
    s += String.Format("{0,-10} {1,-10:N0}{2}",
                     years(index), population(index), vbCrLf)
Next
' Result:
'    Year       Population
'
'    2013       1,025,632
'    2014       1,105,967
'    2015       1,148,203

String.Format bileşik biçimlendirme özelliğini kullanır. Daha fazla bilgi için bkz . Bileşik Biçimlendirme.

Hangi yöntemi çağırmalıyım?

Objective	Çağrılacak yöntem
Geçerli kültürün kurallarını kullanarak bir veya daha fazla nesneyi biçimlendirin.	Parametre provider içeren aşırı yüklemeler dışında, kalan Format aşırı yüklemeler bir parametre ve ardından bir String veya daha fazla nesne parametresi içerir. Bu nedenle, çağırmak istediğiniz aşırı yüklemeyi belirlemeniz Format gerekmez. Dil derleyiciniz, bağımsız değişken listenize göre parametresi olmayan provider aşırı yüklemeler arasından uygun aşırı yüklemeyi seçer. Örneğin, bağımsız değişken listenizde beş bağımsız değişken varsa, derleyici yöntemini çağırır Format(String, Object[]) .
Belirli bir kültürün kurallarını kullanarak bir veya daha fazla nesneyi biçimlendirin.	Her Format aşırı yükleme, bir provider parametresiyle başlar ve ardından bir String parametresi ile bir veya daha fazla nesne parametresi gelir. Bu nedenle, çağırmak istediğiniz belirli Format aşırı yükleme durumunu belirlemeniz gerekmez. Dil derleyiciniz, bağımsız değişken listenize göre parametresi provider olan aşırı yüklemeler arasından uygun aşırı yüklemeyi seçer. Örneğin, bağımsız değişken listenizde beş bağımsız değişken varsa, derleyici yöntemini çağırır Format(IFormatProvider, String, Object[]) .
ICustomFormatter veya IFormattable uygulamasıyla özel bir biçimlendirme işlemi gerçekleştirin.	Parametresi provider olan dört aşırı yüklemeden herhangi biri. Derleyici, bağımsız değişken listenize göre parametresi provider olan aşırı yüklemeler arasından uygun aşırı yüklemeyi seçer.

Kısaca Format yöntemi

Format yönteminin her bir aşırı yüklemesi, bileşik biçim dizesinde, sıfır tabanlı dizinli ve biçim öğeleri olarak adlandırılan yer tutucuları içermek için bileşik biçimlendirme özelliğini kullanır. Çalışma zamanında, her biçim öğesi, parametre listesindeki karşılık gelen bağımsız değişkenin dize temsilcisiyle değiştirilir. Bağımsız değişkenin değeri null ise, biçim öğesi String.Empty ile değiştirilir. Örneğin, aşağıdaki Format(String, Object, Object, Object) yöntem çağrısı, {0}, {1} ve {2} olmak üzere üç biçim öğesi içeren bir biçim dizesi ve üç öğeden oluşan bir bağımsız değişken listesi içerir.

DateTime dat = new DateTime(2012, 1, 17, 9, 30, 0);
string city = "Chicago";
int temp = -16;
string output = String.Format("At {0} in {1}, the temperature was {2} degrees.",
                              dat, city, temp);
Console.WriteLine(output);
// The example displays output like the following:
//    At 1/17/2012 9:30:00 AM in Chicago, the temperature was -16 degrees.

open System

let dat = DateTime(2012, 1, 17, 9, 30, 0) 
let city = "Chicago"
let temp = -16
String.Format("At {0} in {1}, the temperature was {2} degrees.", dat, city, temp)
|> printfn "%s"
// The example displays output like the following:
//    At 1/17/2012 9:30:00 AM in Chicago, the temperature was -16 degrees.

Dim dat As Date = #1/17/2012 9:30AM#
Dim city As String = "Chicago"
Dim temp As Integer = -16
Dim output As String = String.Format("At {0} in {1}, the temperature was {2} degrees.",
                                   dat, city, temp)
Console.WriteLine(output)
' The example displays the following output:
'    At 1/17/2012 9:30:00 AM in Chicago, the temperature was -16 degrees.

Biçim öğesi

Biçim öğesi şu söz dizimine sahiptir:

{index[,width][:formatString]}

Köşeli ayraçlar isteğe bağlı öğeleri belirtir. Açma ve kapatma ayraçları gereklidir. (Biçim dizesine değişmez değer açma veya kapatma ayracı eklemek için Bileşik Biçimlendirme makalesindeki Kaçış Ayraçları bölümüne bakın.)

Örneğin, para birimi değerini biçimlendirmek için bir biçim öğesi şu şekilde görünebilir:

var value = String.Format("{0,-10:C}", 126347.89m);
Console.WriteLine(value);

open System

String.Format("{0,-10:C}", 126347.89m)         
|> printfn "%s"

String.Format("{0,-10:C}", 126347.89D)

Biçim öğesi aşağıdaki öğelere sahiptir:

index
Bu konumdaki dizeye dahil edilecek olan bağımsız değişkenin sıfır tabanlı dizini. Bu bağımsız değişken ise null, dizeye bu konuma boş bir dize eklenir.

width
Optional. Bağımsız değişkenin eklendiği alanın toplam uzunluğunu ve hizalamasının sağa (pozitif tamsayı) veya sola (negatif tamsayı) olduğunu belirten imzalı bir tamsayı. Eğer atlarsanız width, karşılık gelen argümanın dize temsili öncesi veya sonrası boşluk olmayan bir alana eklenir.

Eğer width'nin değeri eklenecek bağımsız değişkenin uzunluğundan küçükse, width yoksayılır ve alan genişliği olarak bağımsız değişkenin dize gösteriminin uzunluğu kullanılır.

formatString
Optional. Karşılık gelen bağımsız değişkenin sonuç dizesinin biçimini belirten dize. Çıkardığınızda formatString, ilgili bağımsız değişkenin parametresiz ToString yöntemi, onun dize gösterimini oluşturmak için çağrılır. Eğer formatString belirtirseniz, biçim öğesi tarafından referans alınan bağımsız değişkenin IFormattable arabirimini uygulaması gerekir. Biçim dizelerini destekleyen türler şunlardır:

• Tüm integral ve kayan nokta türleri. (Bkz. Standart Sayısal Biçim Dizeleri ve Özel Sayısal Biçim Dizeleri.)

• DateTime ve DateTimeOffset. (Bkz. Standart Tarih ve Saat Biçim Dizeleri ve Özel Tarih ve Saat Biçim Dizeleri.)

• Tüm numaralandırma türleri. (Bkz . Numaralandırma Biçimi Dizeleri.)

• TimeSpan Değerler. (Bkz . Standart TimeSpan Biçim Dizeleri ve Özel TimeSpan Biçim Dizeleri.)

• GUID'ler (Yöntemine Guid.ToString(String) bakın.)

Ancak, herhangi bir özel tür IFormattable uygulayabilir veya var olan bir türün IFormattable uygulamasını genişletebilir.

Aşağıdaki örnek, biçimlendirilmiş çıkış oluşturmak için width ve formatString bağımsız değişkenlerini kullanır.

// Create array of 5-tuples with population data for three U.S. cities, 1940-1950.
Tuple<string, DateTime, int, DateTime, int>[] cities =
    { Tuple.Create("Los Angeles", new DateTime(1940, 1, 1), 1504277,
                   new DateTime(1950, 1, 1), 1970358),
      Tuple.Create("New York", new DateTime(1940, 1, 1), 7454995,
                   new DateTime(1950, 1, 1), 7891957),
      Tuple.Create("Chicago", new DateTime(1940, 1, 1), 3396808,
                   new DateTime(1950, 1, 1), 3620962),
      Tuple.Create("Detroit", new DateTime(1940, 1, 1), 1623452,
                   new DateTime(1950, 1, 1), 1849568) };

// Display header
var header = String.Format("{0,-12}{1,8}{2,12}{1,8}{2,12}{3,14}\n",
                              "City", "Year", "Population", "Change (%)");
Console.WriteLine(header);
foreach (var city in cities) {
   var output = String.Format("{0,-12}{1,8:yyyy}{2,12:N0}{3,8:yyyy}{4,12:N0}{5,14:P1}",
                          city.Item1, city.Item2, city.Item3, city.Item4, city.Item5,
                          (city.Item5 - city.Item3)/ (double)city.Item3);
   Console.WriteLine(output);
}
// The example displays the following output:
//    City            Year  Population    Year  Population    Change (%)
//
//    Los Angeles     1940   1,504,277    1950   1,970,358        31.0 %
//    New York        1940   7,454,995    1950   7,891,957         5.9 %
//    Chicago         1940   3,396,808    1950   3,620,962         6.6 %
//    Detroit         1940   1,623,452    1950   1,849,568        13.9 %

// Create a list of 5-tuples with population data for three U.S. cities, 1940-1950.
let cities = 
    [ "Los Angeles", DateTime(1940, 1, 1), 1504277, DateTime(1950, 1, 1), 1970358
      "New York", DateTime(1940, 1, 1), 7454995, DateTime(1950, 1, 1), 7891957
      "Chicago", DateTime(1940, 1, 1), 3396808, DateTime(1950, 1, 1), 3620962
      "Detroit", DateTime(1940, 1, 1), 1623452, DateTime(1950, 1, 1), 1849568 ]

// Display header
String.Format("{0,-12}{1,8}{2,12}{1,8}{2,12}{3,14}\n", "City", "Year", "Population", "Change (%)")
|> printfn "%s"

for name, year1, pop1, year2, pop2 in cities do
    String.Format("{0,-12}{1,8:yyyy}{2,12:N0}{3,8:yyyy}{4,12:N0}{5,14:P1}",
                  name, year1, pop1, year2, pop2,
                  double (pop2 - pop1) / double pop1)
    |> printfn "%s"
// The example displays the following output:
//    City            Year  Population    Year  Population    Change (%)
//  
//    Los Angeles     1940   1,504,277    1950   1,970,358        31.0 %
//    New York        1940   7,454,995    1950   7,891,957         5.9 %
//    Chicago         1940   3,396,808    1950   3,620,962         6.6 %
//    Detroit         1940   1,623,452    1950   1,849,568        13.9 %

Module Example4
    Public Sub Main()
        ' Create array of 5-tuples with population data for three U.S. cities, 1940-1950.
        Dim cities() =
          {Tuple.Create("Los Angeles", #1/1/1940#, 1504277, #1/1/1950#, 1970358),
            Tuple.Create("New York", #1/1/1940#, 7454995, #1/1/1950#, 7891957),
            Tuple.Create("Chicago", #1/1/1940#, 3396808, #1/1/1950#, 3620962),
            Tuple.Create("Detroit", #1/1/1940#, 1623452, #1/1/1950#, 1849568)}

        ' Display header
        Dim header As String = String.Format("{0,-12}{1,8}{2,12}{1,8}{2,12}{3,14}",
                                           "City", "Year", "Population", "Change (%)")
        Console.WriteLine(header)
        Console.WriteLine()
        For Each city In cities
            Dim output = String.Format("{0,-12}{1,8:yyyy}{2,12:N0}{3,8:yyyy}{4,12:N0}{5,14:P1}",
                                city.Item1, city.Item2, city.Item3, city.Item4, city.Item5,
                                (city.Item5 - city.Item3) / city.Item3)
            Console.WriteLine(output)
        Next
    End Sub
End Module
' The example displays the following output:
'    City            Year  Population    Year  Population    Change (%)
'
'    Los Angeles     1940   1,504,277    1950   1,970,358        31.0 %
'    New York        1940   7,454,995    1950   7,891,957         5.9 %
'    Chicago         1940   3,396,808    1950   3,620,962         6.6 %
'    Detroit         1940   1,623,452    1950   1,849,568        13.9 %

Bağımsız değişkenler nasıl biçimlendirilir?

Biçim öğeleri dizenin başından itibaren sıralı olarak işlenir. Her biçim öğesinin, yöntemin bağımsız değişken listesindeki bir nesneye karşılık gelen bir dizini vardır. Format yöntemi bağımsız değişkeni alır ve onun dize gösterimini aşağıdaki gibi türetir:

• Bağımsız değişken null ise, yöntem String.Empty değerini sonuç dizesine ekler. Null bağımsız değişkenler için bir NullReferenceException işlemeyle uğraşmanıza gerek yok.
• Eğer Format(IFormatProvider, String, Object[]) aşırı yüklemesini çağırır ve provider nesnesinin IFormatProvider.GetFormat uygulaması null olmayan bir ICustomFormatter uygulaması dönerse, bağımsız değişken ICustomFormatter.Format(String, Object, IFormatProvider) metoduna geçirilir. Biçim öğesi bir formatString bağımsız değişken içeriyorsa, bir yönteme ilk bağımsız değişken olarak geçirilir. ICustomFormatter Uygulama kullanılabilirse ve null olmayan bir dize oluşturursa, bu dize bağımsız değişkenin dize gösterimi olarak döndürülür; aksi takdirde, sonraki adım yürütülür.
• Eğer bağımsız değişken IFormattable arabirimini uyguluyorsa, IFormattable.ToString uygulaması çağrılır.
• Temel sınıf uygulamasını geçersiz kılan veya bir temel sınıf uygulamasından devralan parametresiz ToString yöntemi çağrılır.

Örneğin, ICustomFormatter.Format yöntemine yapılan çağrıları kesen ve bileşik biçim dizesindeki her biçim öğesi için bir biçimlendirme yöntemine hangi bilgileri Format yöntemi geçtiğini görmenizi sağlayan bir örnek için bkz. Örnek: Araya girme sağlayıcısı ve Roma rakamı biçimlendiricisi.

Daha fazla bilgi için bkz. Sipariş işleme.

Aynı dizine sahip öğeleri biçimlendirme

Eğer bir Format yöntemi, bir dizin öğesinin indeksi, bağımsız değişken listesindeki bağımsız değişken sayısından büyük veya buna eşitse bir FormatException istisnası fırlatır. Ancak, format birden çok biçim öğesi aynı dizine sahip olduğu sürece bağımsız değişkenlerden daha fazla biçim öğesi içerebilir. Aşağıdaki örnekte, Format(String, Object) yöntemine yapılan çağrıda, bağımsız değişken listesinin tek bir bağımsız değişkeni vardır, ancak biçim dizesi iki biçim öğesi içerir: biri sayının ondalık değerini, diğeri ise onaltılık değerini gösterir.

short[] values= { Int16.MinValue, -27, 0, 1042, Int16.MaxValue };
Console.WriteLine("{0,10}  {1,10}\n", "Decimal", "Hex");
foreach (short value in values)
{
   string formatString = String.Format("{0,10:G}: {0,10:X}", value);
   Console.WriteLine(formatString);
}
// The example displays the following output:
//       Decimal         Hex
//
//        -32768:       8000
//           -27:       FFE5
//             0:          0
//          1042:        412
//         32767:       7FFF

open System

let values= [| Int16.MinValue; -27s; 0s; 1042s; Int16.MaxValue |]
printfn "%10s  %10s\n" "Decimal" "Hex"
for value in values do
    String.Format("{0,10:G}: {0,10:X}", value)
    |> printfn "%s"
// The example displays the following output:
//       Decimal         Hex
//    
//        -32768:       8000
//           -27:       FFE5
//             0:          0
//          1042:        412
//         32767:       7FFF

Module Example1
    Public Sub Main()
        Dim values() As Short = {Int16.MinValue, -27, 0, 1042, Int16.MaxValue}
        Console.WriteLine("{0,10}  {1,10}", "Decimal", "Hex")
        Console.WriteLine()
        For Each value As Short In values
            Dim formatString As String = String.Format("{0,10:G}: {0,10:X}", value)
            Console.WriteLine(formatString)
        Next
    End Sub
End Module
' The example displays the following output:
'       Decimal         Hex
'    
'        -32768:       8000
'           -27:       FFE5
'             0:          0
'          1042:        412
'         32767:       7FFF

Biçim ve kültür

Genellikle, bağımsız değişken listesindeki nesneler, özelliği tarafından CultureInfo.CurrentCulture döndürülen geçerli kültürün kuralları kullanılarak dize gösterimlerine dönüştürülür. Format parametresini içeren aşırı yüklemelerinden birini çağırarak provider ile bu davranışı denetleyebilirsiniz. provider parametresi, biçimlendirme işleminin denetlenmesi için kullanılan özel ve kültüre özgü biçimlendirme bilgileri sağlayan bir IFormatProvider uygulamadır.

Arabirim IFormatProvider , GetFormatbiçimlendirme bilgileri sağlayan nesneyi döndürmekten sorumlu olan tek bir üyesine sahiptir. .NET'in kültüre özgü biçimlendirme sağlayan üç IFormatProvider uygulaması vardır:

• CultureInfo. Yöntemi GetFormat , sayısal değerleri biçimlendirmek için kültüre özgü NumberFormatInfo bir nesne ve tarih ve saat değerlerini biçimlendirmek için kültüre özgü DateTimeFormatInfo bir nesne döndürür.
• DateTimeFormatInfo, tarih ve saat değerlerinin kültüre özgü biçimlendirmesi için kullanılır. Bu GetFormat yöntemi, kendisini döndürür.
• NumberFormatInfo, sayısal değerlerin kültüre özgü biçimlendirmesi için kullanılır. Bu GetFormat(Type) yöntemi, kendisini döndürür.

Özel biçimlendirme işlemleri

Ayrıca, özel biçimlendirme işlemleri gerçekleştirmek için türü parametresine sahip Format yöntemin aşırı yüklemelerinden providerIFormatProvider herhangi birini çağırabilirsiniz. Örneğin, bir tamsayıyı kimlik numarası veya telefon numarası olarak biçimlendirebilirsiniz. Özel biçimlendirme gerçekleştirmek için bağımsız değişkeninizin provider hem hem IFormatProvider de ICustomFormatter arabirimlerini uygulaması gerekir. Format yöntemi, ICustomFormatter bağımsız değişken olarak bir provider uygulaması ile geçirildiğinde, Format yöntemi kendi IFormatProvider.GetFormat uygulamasını çağırır ve ICustomFormatter türünde bir nesne talep eder. Ardından, döndürülen ICustomFormatter nesnesinin Format yöntemini çağırarak, kendisine geçirilen bileşik dizedeki her biçim öğesini biçimlendirir.

Özel biçimlendirme çözümleri sağlama hakkında daha fazla bilgi için bkz . Nasıl yapılır: Özel Sayısal Biçim Sağlayıcılarını Tanımlama ve Kullanma ve ICustomFormatter. Tamsayıları biçimlendirilmiş özel sayılara dönüştüren bir örnek için bkz . Örnek: Özel biçimlendirme işlemi. İşaretsiz baytları Romen rakamlarına dönüştüren bir örnek için bkz . Örnek: Kesme noktası sağlayıcısı ve Roma rakamı biçimlendiricisi.

Örnek: Özel biçimlendirme işlemi

Bu örnek, x-xxxxx-xx biçiminde bir tamsayı değerini müşteri hesap numarası olarak biçimlendiren bir biçim sağlayıcısı tanımlar.

using System;

public class TestFormatter
{
   public static void Main()
   {
      int acctNumber = 79203159;
      Console.WriteLine(String.Format(new CustomerFormatter(), "{0}", acctNumber));
      Console.WriteLine(String.Format(new CustomerFormatter(), "{0:G}", acctNumber));
      Console.WriteLine(String.Format(new CustomerFormatter(), "{0:S}", acctNumber));
      Console.WriteLine(String.Format(new CustomerFormatter(), "{0:P}", acctNumber));
      try {
         Console.WriteLine(String.Format(new CustomerFormatter(), "{0:X}", acctNumber));
      }
      catch (FormatException e) {
         Console.WriteLine(e.Message);
      }
   }
}

public class CustomerFormatter : IFormatProvider, ICustomFormatter
{
   public object GetFormat(Type formatType) 
   {
      if (formatType == typeof(ICustomFormatter))        
         return this; 
      else
         return null;
   }
   
   public string Format(string format, 
                         object arg, 
                         IFormatProvider formatProvider) 
   {                       
      if (! this.Equals(formatProvider))
      {
         return null;
      }
      else
      {
         if (String.IsNullOrEmpty(format)) 
            format = "G";
         
         string customerString = arg.ToString();
         if (customerString.Length < 8)
            customerString = customerString.PadLeft(8, '0');
         
         format = format.ToUpper();
         switch (format)
         {
            case "G":
               return customerString.Substring(0, 1) + "-" +
                                     customerString.Substring(1, 5) + "-" +
                                     customerString.Substring(6);
            case "S":                          
               return customerString.Substring(0, 1) + "/" +
                                     customerString.Substring(1, 5) + "/" +
                                     customerString.Substring(6);
            case "P":                          
               return customerString.Substring(0, 1) + "." +
                                     customerString.Substring(1, 5) + "." +
                                     customerString.Substring(6);
            default:
               throw new FormatException( 
                         String.Format("The '{0}' format specifier is not supported.", format));
         }
      }   
   }
}
// The example displays the following output:
//       7-92031-59
//       7-92031-59
//       7/92031/59
//       7.92031.59
//       The 'X' format specifier is not supported.

open System

type CustomerFormatter() = 
    interface IFormatProvider with
        member this.GetFormat(formatType) =
            if formatType = typeof<ICustomFormatter> then
                this
            else
                null

    interface ICustomFormatter with
        member this.Format(format, arg, formatProvider: IFormatProvider) = 
            if this.Equals formatProvider |> not then
                null
            else
                let format = 
                    if String.IsNullOrEmpty format then "G"
                    else format.ToUpper()
                
                let customerString = 
                    let s = string arg
                    if s.Length < 8 then
                        s.PadLeft(8, '0')
                    else s
                
                match format with
                | "G" ->
                    customerString.Substring(0, 1) + "-" +
                        customerString.Substring(1, 5) + "-" +
                        customerString.Substring 6
                | "S" ->                          
                    customerString.Substring(0, 1) + "/" +
                        customerString.Substring(1, 5) + "/" +
                        customerString.Substring 6
                | "P" ->                          
                    customerString.Substring(0, 1) + "." +
                        customerString.Substring(1, 5) + "." +
                        customerString.Substring 6
                | _ ->
                    raise (FormatException $"The '{format}' format specifier is not supported.")

let acctNumber = 79203159
String.Format(CustomerFormatter(), "{0}", acctNumber)
|> printfn "%s"
String.Format(CustomerFormatter(), "{0:G}", acctNumber)
|> printfn "%s"
String.Format(CustomerFormatter(), "{0:S}", acctNumber)
|> printfn "%s"
String.Format(CustomerFormatter(), "{0:P}", acctNumber)
|> printfn "%s"
try
    String.Format(CustomerFormatter(), "{0:X}", acctNumber)
    |> printfn "%s"
with :? FormatException as e ->
    printfn $"{e.Message}"

// The example displays the following output:
//       7-92031-59
//       7-92031-59
//       7/92031/59
//       7.92031.59
//       The 'X' format specifier is not supported.

Module TestFormatter
   Public Sub Main()
      Dim acctNumber As Integer = 79203159
      Console.WriteLine(String.Format(New CustomerFormatter, "{0}", acctNumber))
      Console.WriteLine(String.Format(New CustomerFormatter, "{0:G}", acctNumber))
      Console.WriteLine(String.Format(New CustomerFormatter, "{0:S}", acctNumber))
      Console.WriteLine(String.Format(New CustomerFormatter, "{0:P}", acctNumber))
      Try
         Console.WriteLine(String.Format(New CustomerFormatter, "{0:X}", acctNumber))
      Catch e As FormatException
         Console.WriteLine(e.Message)
      End Try   
   End Sub
End Module

Public Class CustomerFormatter : Implements IFormatProvider, ICustomFormatter
   Public Function GetFormat(type As Type) As Object  _
                   Implements IFormatProvider.GetFormat
      If type Is GetType(ICustomFormatter) Then
         Return Me
      Else
         Return Nothing
      End If
   End Function
   
   Public Function Format(fmt As String, _
                           arg As Object, _
                           formatProvider As IFormatProvider) As String _
                    Implements ICustomFormatter.Format
      If Not Me.Equals(formatProvider) Then
         Return Nothing
      Else
         If String.IsNullOrEmpty(fmt) Then fmt = "G"
         
         Dim customerString As String = arg.ToString()
         if customerString.Length < 8 Then _
            customerString = customerString.PadLeft(8, "0"c)
         
         Select Case fmt
            Case "G"
               Return customerString.Substring(0, 1) & "-" & _
                                     customerString.Substring(1, 5) & "-" & _
                                     customerString.Substring(6)
            Case "S"                         
               Return customerString.Substring(0, 1) & "/" & _
                                     customerString.Substring(1, 5) & "/" & _
                                     customerString.Substring(6)
            Case "P"
               Return customerString.Substring(0, 1) & "." & _
                                     customerString.Substring(1, 5) & "." & _
                                     customerString.Substring(6)
            Case Else
               Throw New FormatException( _
                         String.Format("The '{0}' format specifier is not supported.", fmt))
         End Select                                                     
      End If   
   End Function
End Class
' The example displays the following output:
'       7-92031-59
'       7-92031-59
'       7/92031/59
'       7.92031.59
'       The 'X' format specifier is not supported.

Örnek: Kesme noktası sağlayıcısı ve Roma rakamı biçimlendiricisi

Bu örnek, iki şey yapmak için ICustomFormatter ve IFormatProvider arabirimlerini uygulayan bir özel biçim sağlayıcısı tanımlar.

• Kendi ICustomFormatter.Format uygulamasına geçirilen parametreleri görüntüler. Bu, yöntemin Format(IFormatProvider, String, Object[]) biçimlendirmeye çalıştığı her nesne için özel biçimlendirme uygulamasına hangi parametreleri geçirdiğini görmemizi sağlar. Bu, uygulamanızda hata ayıklarken yararlı olabilir.
• Biçimlendirilecek nesne "R" standart biçim dizesi kullanılarak biçimlendirilecek imzasız bir bayt değeriyse, özel biçimlendirici sayısal değeri Roma rakamı olarak biçimlendirir.

using System;
using System.Globalization;

public class InterceptProvider : IFormatProvider, ICustomFormatter
{
   public object GetFormat(Type formatType)
   {
      if (formatType == typeof(ICustomFormatter))
         return this;
      else
         return null;
   }

   public string Format(String format, Object obj, IFormatProvider provider)
   {
      // Display information about method call.
      string formatString = format ?? "<null>";
      Console.WriteLine("Provider: {0}, Object: {1}, Format String: {2}",
                        provider.GetType().Name, obj ?? "<null>", formatString);

      if (obj == null) return String.Empty;

      // If this is a byte and the "R" format string, format it with Roman numerals.
      if (obj is Byte && formatString.ToUpper().Equals("R")) {
         Byte value = (Byte) obj;
         int remainder;
         int result;
         String returnString = String.Empty;

         // Get the hundreds digit(s)
         result = Math.DivRem(value, 100, out remainder);
         if (result > 0)
            returnString = new String('C', result);
         value = (Byte) remainder;
         // Get the 50s digit
         result = Math.DivRem(value, 50, out remainder);
         if (result == 1)
            returnString += "L";
         value = (Byte) remainder;
         // Get the tens digit.
         result = Math.DivRem(value, 10, out remainder);
         if (result > 0)
            returnString += new String('X', result);
         value = (Byte) remainder;
         // Get the fives digit.
         result = Math.DivRem(value, 5, out remainder);
         if (result > 0)
            returnString += "V";
         value = (Byte) remainder;
         // Add the ones digit.
         if (remainder > 0)
            returnString += new String('I', remainder);

         // Check whether we have too many X characters.
         int pos = returnString.IndexOf("XXXX");
         if (pos >= 0) {
            int xPos = returnString.IndexOf("L");
            if (xPos >= 0 & xPos == pos - 1)
               returnString = returnString.Replace("LXXXX", "XC");
            else
               returnString = returnString.Replace("XXXX", "XL");
         }
         // Check whether we have too many I characters
         pos = returnString.IndexOf("IIII");
         if (pos >= 0)
            if (returnString.IndexOf("V") >= 0)
               returnString = returnString.Replace("VIIII", "IX");
            else
               returnString = returnString.Replace("IIII", "IV");

         return returnString;
      }

      // Use default for all other formatting.
      if (obj is IFormattable)
         return ((IFormattable) obj).ToString(format, CultureInfo.CurrentCulture);
      else
         return obj.ToString();
   }
}

public class FormatExample12
{
   public static void Main()
   {
      int n = 10;
      double value = 16.935;
      DateTime day = DateTime.Now;
      InterceptProvider provider = new InterceptProvider();
      Console.WriteLine(String.Format(provider, "{0:N0}: {1:C2} on {2:d}\n", n, value, day));
      Console.WriteLine(String.Format(provider, "{0}: {1:F}\n", "Today: ",
                                      (DayOfWeek) DateTime.Now.DayOfWeek));
      Console.WriteLine(String.Format(provider, "{0:X}, {1}, {2}\n",
                                      (Byte) 2, (Byte) 12, (Byte) 199));
      Console.WriteLine(String.Format(provider, "{0:R}, {1:R}, {2:R}\n",
                                      (Byte) 2, (Byte) 12, (Byte) 199));
   }
}
// The example displays the following output:
//    Provider: InterceptProvider, Object: 10, Format String: N0
//    Provider: InterceptProvider, Object: 16.935, Format String: C2
//    Provider: InterceptProvider, Object: 1/31/2013 6:10:28 PM, Format String: d
//    10: $16.94 on 1/31/2013
//
//    Provider: InterceptProvider, Object: Today: , Format String: <null>
//    Provider: InterceptProvider, Object: Thursday, Format String: F
//    Today: : Thursday
//
//    Provider: InterceptProvider, Object: 2, Format String: X
//    Provider: InterceptProvider, Object: 12, Format String: <null>
//    Provider: InterceptProvider, Object: 199, Format String: <null>
//    2, 12, 199
//
//    Provider: InterceptProvider, Object: 2, Format String: R
//    Provider: InterceptProvider, Object: 12, Format String: R
//    Provider: InterceptProvider, Object: 199, Format String: R
//    II, XII, CXCIX

open System
open System.Globalization

type InterceptProvider() =
    interface IFormatProvider with
        member this.GetFormat(formatType) =
            if formatType = typeof<ICustomFormatter> then
                this
            else
                null
    interface ICustomFormatter with
        member _.Format(format, obj, provider: IFormatProvider) = 
            // Display information about method call.
            let formatString =
                if format = null then "<null>" else format
            printfn $"Provider: {provider.GetType().Name}, Object: %A{obj}, Format String: %s{formatString}"
                                
            if obj = null then
                String.Empty
            else
                // If this is a byte and the "R" format string, format it with Roman numerals.
                match obj with
                | :? byte as value when formatString.ToUpper().Equals "R" -> 
                    let mutable returnString = String.Empty

                    // Get the hundreds digit(s)
                    let struct (result, remainder) = Math.DivRem(value, 100uy)
                    if result > 0uy then
                        returnString <- String('C', int result)
                    let value = byte remainder
                    // Get the 50s digit
                    let struct (result, remainder) = Math.DivRem(value, 50uy)
                    if result = 1uy then
                        returnString <- returnString + "L"
                    let value = byte remainder
                    // Get the tens digit.
                    let struct (result, remainder) = Math.DivRem(value, 10uy)
                    if result > 0uy then
                        returnString <- returnString + String('X', int result)
                    let value = byte remainder 
                    // Get the fives digit.
                    let struct (result, remainder) = Math.DivRem(value, 5uy)
                    if result > 0uy then
                        returnString <- returnString + "V"
                    let value = byte remainder
                    // Add the ones digit.
                    if remainder > 0uy then 
                        returnString <- returnString + String('I', int remainder)
                    
                    // Check whether we have too many X characters.
                    let pos = returnString.IndexOf "XXXX"
                    if pos >= 0 then
                        let xPos = returnString.IndexOf "L" 
                        returnString <-
                            if xPos >= 0 && xPos = pos - 1 then
                                returnString.Replace("LXXXX", "XC")
                            else
                                returnString.Replace("XXXX", "XL")   
                    // Check whether we have too many I characters
                    let pos = returnString.IndexOf "IIII"
                    if pos >= 0 then
                        returnString <-
                            if returnString.IndexOf "V" >= 0 then
                                returnString.Replace("VIIII", "IX")
                            else
                                returnString.Replace("IIII", "IV")    
                    returnString 

                // Use default for all other formatting.
                | :? IFormattable as x ->
                    x.ToString(format, CultureInfo.CurrentCulture)
                | _ ->
                    string obj

let n = 10
let value = 16.935
let day = DateTime.Now
let provider = InterceptProvider()
String.Format(provider, "{0:N0}: {1:C2} on {2:d}\n", n, value, day)
|> printfn "%s"
String.Format(provider, "{0}: {1:F}\n", "Today: ", DateTime.Now.DayOfWeek)
|> printfn "%s"
String.Format(provider, "{0:X}, {1}, {2}\n", 2uy, 12uy, 199uy)
|> printfn "%s"
String.Format(provider, "{0:R}, {1:R}, {2:R}\n", 2uy, 12uy, 199uy)
|> printfn "%s"
// The example displays the following output:
//    Provider: InterceptProvider, Object: 10, Format String: N0
//    Provider: InterceptProvider, Object: 16.935, Format String: C2
//    Provider: InterceptProvider, Object: 1/31/2013 6:10:28 PM, Format String: d
//    10: $16.94 on 1/31/2013
//    
//    Provider: InterceptProvider, Object: Today: , Format String: <null>
//    Provider: InterceptProvider, Object: Thursday, Format String: F
//    Today: : Thursday
//    
//    Provider: InterceptProvider, Object: 2, Format String: X
//    Provider: InterceptProvider, Object: 12, Format String: <null>
//    Provider: InterceptProvider, Object: 199, Format String: <null>
//    2, 12, 199
//    
//    Provider: InterceptProvider, Object: 2, Format String: R
//    Provider: InterceptProvider, Object: 12, Format String: R
//    Provider: InterceptProvider, Object: 199, Format String: R
//    II, XII, CXCIX

Imports System.Globalization

Public Class InterceptProvider : Implements IFormatProvider, ICustomFormatter
   Public Function GetFormat(formatType As Type) As Object _
         Implements IFormatProvider.GetFormat
      If formatType Is GetType(ICustomFormatter) Then
         Return Me
      Else
         Return Nothing
      End If
   End Function

   Public Function Format(fmt As String, obj As Object, provider As IFormatProvider) As String _
         Implements ICustomFormatter.Format

      Dim formatString As String = If(fmt IsNot Nothing, fmt, "<null>")
      Console.WriteLine("Provider: {0}, Object: {1}, Format String: {2}",
                        provider, If(obj IsNot Nothing, obj, "<null>"), formatString)

      If obj Is Nothing Then Return String.Empty

      ' If this is a byte and the "R" format string, format it with Roman numerals.
      If TypeOf(obj) Is Byte AndAlso formatString.ToUpper.Equals("R") Then
         Dim value As Byte = CByte(obj)
         Dim remainder As Integer
         Dim result As Integer
         Dim returnString As String = String.Empty

         ' Get the hundreds digit(s)
         result = Math.DivRem(value, 100, remainder)
         If result > 0 Then returnString = New String("C"c, result)
         value = CByte(remainder)
         ' Get the 50s digit
         result = Math.DivRem(value, 50, remainder)
         If result = 1 Then returnString += "L"
         value = CByte(remainder)
         ' Get the tens digit.
         result = Math.DivRem(value, 10, remainder)
         If result > 0 Then returnString += New String("X"c, result)
         value = CByte(remainder)
         ' Get the fives digit.
         result = Math.DivRem(value, 5, remainder)
         If result > 0 Then returnString += "V"
         value = CByte(remainder)
         ' Add the ones digit.
         If remainder > 0 Then returnString += New String("I"c, remainder)

         ' Check whether we have too many X characters.
         Dim pos As Integer = returnString.IndexOf("XXXX")
         If pos >= 0 Then
            Dim xPos As Integer = returnString.IndexOf("L")
            If xPos >= 0 And xPos = pos - 1 Then
               returnString = returnString.Replace("LXXXX", "XC")
            Else
               returnString = returnString.Replace("XXXX", "XL")
            End If
         End If
         ' Check whether we have too many I characters
         pos = returnString.IndexOf("IIII")
         If pos >= 0 Then
            If returnString.IndexOf("V") >= 0 Then
               returnString = returnString.Replace("VIIII", "IX")
            Else
               returnString = returnString.Replace("IIII", "IV")
            End If
         End If
         Return returnString
      End If

      ' Use default for all other formatting.
      If TypeOf obj Is IFormattable Then
         Return CType(obj, IFormattable).ToString(fmt, CultureInfo.CurrentCulture)
      Else
         Return obj.ToString()
      End If
   End Function
End Class

Module Example
   Public Sub Main()
      Dim n As Integer = 10
      Dim value As Double = 16.935
      Dim day As DateTime = Date.Now
      Dim provider As New InterceptProvider()
      Console.WriteLine(String.Format(provider, "{0:N0}: {1:C2} on {2:d}", n, value, day))
      Console.WriteLine()
      Console.WriteLine(String.Format(provider, "{0}: {1:F}", "Today",
                                      CType(Date.Now.DayOfWeek, DayOfWeek)))
      Console.WriteLine()
      Console.WriteLine(String.Format(provider, "{0:X}, {1}, {2}\n",
                                      CByte(2), CByte(12), CByte(199)))
      Console.WriteLine()
      Console.WriteLine(String.Format(provider, "{0:R}, {1:R}, {2:R}",
                                      CByte(2), CByte(12), CByte(199)))
   End Sub
End Module
' The example displays the following output:
'    Provider: InterceptProvider, Object: 10, Format String: N0
'    Provider: InterceptProvider, Object: 16.935, Format String: C2
'    Provider: InterceptProvider, Object: 1/31/2013 6:10:28 PM, Format String: d
'    10: $16.94 on 1/31/2013
'
'    Provider: InterceptProvider, Object: Today: , Format String: <null>
'    Provider: InterceptProvider, Object: Thursday, Format String: F
'    Today: : Thursday
'
'    Provider: InterceptProvider, Object: 2, Format String: X
'    Provider: InterceptProvider, Object: 12, Format String: <null>
'    Provider: InterceptProvider, Object: 199, Format String: <null>
'    2, 12, 199
'
'    Provider: InterceptProvider, Object: 2, Format String: R
'    Provider: InterceptProvider, Object: 12, Format String: R
'    Provider: InterceptProvider, Object: 199, Format String: R
'    II, XII, CXCIX

Sıkça Sorulan Sorular

String.Format yöntemine yapılan çağrılar yerine neden dize enterpolasyonu önerirsiniz?

Dize interpolasyonu:

• Daha esnek. Bileşik biçimlendirmeyi destekleyen bir yönteme çağrı gerektirmeden herhangi bir dizede kullanılabilir. Aksi takdirde Format yöntemini veya Console.WriteLine ya da StringBuilder.AppendFormat gibi bileşik biçimlendirmeyi destekleyen başka bir yöntemi çağırmanız gerekir.
• Daha okunabilir. Dizeye eklenecek ifade bağımsız değişken listesinde değil, ilişkilendirilmiş ifadede göründüğünden, ilişkilendirilmiş dizelerin kodlanıp okunması daha kolaydır. İlişkili dizeler, daha kısa ve daha net kodlar üretmek için dize birleştirme işlemlerinde de kullanılabilir.

Aşağıdaki iki kod örneğinin karşılaştırması, ilişkilendirilmiş dizelerin dize birleştirme ve bileşik biçimlendirme yöntemlerine çağrılar üzerindeki üstünlüğünü gösterir. Aşağıdaki örnekte birden çok dize birleştirme işleminin kullanılması ayrıntılı ve okunması zor kodlar oluşturur.

string[] names = { "Balto", "Vanya", "Dakota", "Samuel", "Koani", "Yiska", "Yuma" };
string output = names[0] + ", " + names[1] + ", " + names[2] + ", " +
                names[3] + ", " + names[4] + ", " + names[5] + ", " +
                names[6];

output += "\n";
var date = DateTime.Now;
output += String.Format("It is {0:t} on {0:d}. The day of the week is {1}.",
                        date, date.DayOfWeek);
Console.WriteLine(output);
// The example displays the following output:
//     Balto, Vanya, Dakota, Samuel, Koani, Yiska, Yuma
//     It is 10:29 AM on 1/8/2018. The day of the week is Monday.

open System

let names = [| "Balto"; "Vanya"; "Dakota"; "Samuel"; "Koani"; "Yiska"; "Yuma" |]
let output = 
    names[0] + ", " + names[1] + ", " + names[2] + ", " + 
    names[3] + ", " + names[4] + ", " + names[5] + ", " + 
    names[6] + "\n"

let date = DateTime.Now
output + String.Format("It is {0:t} on {0:d}. The day of the week is {1}.", date, date.DayOfWeek)
|> printfn "%s"
// The example displays the following output:
//     Balto, Vanya, Dakota, Samuel, Koani, Yiska, Yuma
//     It is 10:29 AM on 1/8/2018. The day of the week is Monday.

Module Example12
    Public Sub Main()
        Dim names = {"Balto", "Vanya", "Dakota", "Samuel", "Koani", "Yiska", "Yuma"}
        Dim output = names(0) + ", " + names(1) + ", " + names(2) + ", " +
                   names(3) + ", " + names(4) + ", " + names(5) + ", " +
                   names(6)

        output += vbCrLf
        Dim dat = DateTime.Now
        output += String.Format("It is {0:t} on {0:d}. The day of the week is {1}.",
                              dat, dat.DayOfWeek)
        Console.WriteLine(output)
    End Sub
End Module
' The example displays the following output:
'     Balto, Vanya, Dakota, Samuel, Koani, Yiska, Yuma
'     It is 10:29 AM on 1/8/2018. The day of the week is Monday.

Buna karşılık, aşağıdaki örnekte ilişkilendirilmiş dizelerin kullanılması, dize birleştirme deyiminden ve önceki örnekteki yöntem çağrısından Format çok daha net ve daha kısa bir kod üretir.

string[] names = { "Balto", "Vanya", "Dakota", "Samuel", "Koani", "Yiska", "Yuma" };
string output = $"{names[0]}, {names[1]}, {names[2]}, {names[3]}, {names[4]}, " +
                $"{names[5]}, {names[6]}";

var date = DateTime.Now;
output += $"\nIt is {date:t} on {date:d}. The day of the week is {date.DayOfWeek}.";
Console.WriteLine(output);
// The example displays the following output:
//     Balto, Vanya, Dakota, Samuel, Koani, Yiska, Yuma
//     It is 10:29 AM on 1/8/2018. The day of the week is Monday.

open System

let names = [| "Balto"; "Vanya"; "Dakota"; "Samuel"; "Koani"; "Yiska"; "Yuma" |]
let output = $"{names[0]}, {names[1]}, {names[2]}, {names[3]}, {names[4]}, {names[5]}, {names[6]}"  

let date = DateTime.Now
output + $"\nIt is {date:t} on {date:d}. The day of the week is {date.DayOfWeek}."
|> printfn "%s" 
// The example displays the following output:
//     Balto, Vanya, Dakota, Samuel, Koani, Yiska, Yuma
//     It is 10:29 AM on 1/8/2018. The day of the week is Monday.

Module Example13
    Public Sub Main()
        Dim names = {"Balto", "Vanya", "Dakota", "Samuel", "Koani", "Yiska", "Yuma"}
        Dim output = $"{names(0)}, {names(1)}, {names(2)}, {names(3)}, {names(4)}, " +
                   $"{names(5)}, {names(6)}"

        Dim dat = DateTime.Now
        output += $"{vbCrLf}It is {dat:t} on {dat:d}. The day of the week is {dat.DayOfWeek}."
        Console.WriteLine(output)
    End Sub
End Module
' The example displays the following output:
'     Balto, Vanya, Dakota, Samuel, Koani, Yiska, Yuma
'     It is 10:29 AM on 1/8/2018. The day of the week is Monday.

Önceden tanımlanmış biçim dizelerini nerede bulabilirim?

• Tüm tam sayı ve kayan nokta türleri için bkz. Standart Sayısal Biçim Dizeleri ve Özel Sayısal Biçim Dizeleri.
• Tarih ve saat değerleri için bkz. Standart Tarih ve Saat Biçim Dizeleri ve Özel Tarih ve Saat Biçim Dizeleri.
• Numaralandırma değerleri için bkz. Numaralandırma Biçimi Dizeleri.
• Değerler için TimeSpan bkz. Standart TimeSpan Biçim Dizeleri ve Özel TimeSpan Biçim Dizeleri.
• Guid değerleri için Guid.ToString(String) başvuru sayfasının Açıklamalar bölümüne bakın.

Biçim öğelerinin yerini alan sonuç dizelerinin hizalamasını nasıl denetleyebilirim?

Biçim öğesinin genel söz dizimi şöyledir:

{index[,width][: formatString]}

width , alan genişliğini tanımlayan imzalı bir tamsayıdır. Bu değer negatifse, alandaki metin sola hizalanır. Pozitifse, metin sağa hizalanır.

Ondalık ayırıcıdan sonraki basamak sayısını nasıl denetleyebilirim?

"D" (yalnızca tamsayılarla kullanılır), "G", "R" ve "X" dışındaki tüm standart sayısal biçim dizeleri , sonuç dizesindeki ondalık basamak sayısını tanımlayan bir duyarlık tanımlayıcısına izin verir. Aşağıdaki örnek, sonuç dizesindeki ondalık basamak sayısını denetlemek için standart sayısal biçim dizelerini kullanır.

object[] values = { 1603, 1794.68235, 15436.14 };
string result;
foreach (var value in values)
{
    result = String.Format("{0,12:C2}   {0,12:E3}   {0,12:F4}   {0,12:N3}  {1,12:P2}\n",
                           Convert.ToDouble(value), Convert.ToDouble(value) / 10000);
    Console.WriteLine(result);
}
// The example displays output like the following:
//       $1,603.00     1.603E+003      1603.0000      1,603.000       16.03 %
//
//       $1,794.68     1.795E+003      1794.6824      1,794.682       17.95 %
//
//      $15,436.14     1.544E+004     15436.1400     15,436.140      154.36 %

open System

let values: obj list = [ 1603, 1794.68235, 15436.14 ]
for value in values do
   String.Format("{0,12:C2}   {0,12:E3}   {0,12:F4}   {0,12:N3}  {1,12:P2}\n", Convert.ToDouble(value), Convert.ToDouble(value) / 10000.)
   |> printfn "%s"
// The example displays output like the following:
//       $1,603.00     1.603E+003      1603.0000      1,603.000       16.03 %
//    
//       $1,794.68     1.795E+003      1794.6824      1,794.682       17.95 %
//    
//      $15,436.14     1.544E+004     15436.1400     15,436.140      154.36 %

Module Example7
    Public Sub Main()
        Dim values() As Object = {1603, 1794.68235, 15436.14}
        Dim result As String
        For Each value In values
            result = String.Format("{0,12:C2}   {0,12:E3}   {0,12:F4}   {0,12:N3}  {1,12:P2}",
                                value, CDbl(value) / 10000)
            Console.WriteLine(result)
            Console.WriteLine()
        Next
    End Sub
End Module
' The example displays the following output:
'       $1,603.00     1.603E+003      1603.0000      1,603.000       16.03 %
'    
'       $1,794.68     1.795E+003      1794.6824      1,794.682       17.95 %
'    
'      $15,436.14     1.544E+004     15436.1400     15,436.140      154.36 %

Özel sayısal biçim dizesi kullanıyorsanız, aşağıdaki örnekte gösterildiği gibi sonuç dizesindeki ondalık basamak sayısını denetlemek için "0" biçim tanımlayıcısını kullanın.

decimal value = 16309.5436m;
string result = String.Format("{0,12:#.00000} {0,12:0,000.00} {0,12:000.00#}",
                              value);
Console.WriteLine(result);
// The example displays the following output:
//        16309.54360    16,309.54    16309.544

let value = 16309.5436m
String.Format("{0,12:#.00000} {0,12:0,000.00} {0,12:000.00#}", value)
|> printfn "%s"
// The example displays the following output:
//        16309.54360    16,309.54    16309.544

Module Example8
    Public Sub Main()
        Dim value As Decimal = 16309.5436D
        Dim result As String = String.Format("{0,12:#.00000} {0,12:0,000.00} {0,12:000.00#}",
                                           value)
        Console.WriteLine(result)
    End Sub
End Module
' The example displays the following output:
'    16309.54360    16,309.54    16309.544

İntegral basamak sayısını nasıl denetleyebilirim?

Varsayılan olarak, biçimlendirme işlemleri yalnızca sıfır olmayan tam sayı basamaklarını görüntüler. Tamsayıları biçimlendiriyorsanız, basamak sayısını denetlemek için "D" ve "X" standart biçim dizeleriyle bir hassasiyet belirleyici kullanabilirsiniz.

int value = 1326;
string result = String.Format("{0,10:D6} {0,10:X8}", value);
Console.WriteLine(result);
// The example displays the following output:
//     001326   0000052E

open System

let value = 1326
String.Format("{0,10:D6} {0,10:X8}", value)
|> printfn "%s"
// The example displays the following output:
//     001326   0000052E

Module Example10
    Public Sub Main()
        Dim value As Integer = 1326
        Dim result As String = String.Format("{0,10:D6} {0,10:X8}", value)
        Console.WriteLine(result)
    End Sub
End Module
' The example displays the following output:
'       001326   0000052E

Aşağıdaki örnekte gösterildiği gibi, "0" özel sayısal biçim belirticisini kullanarak belirtilen sayıda tamsayı basamak içeren bir sonuç dizesi oluşturmak için bir tamsayıyı veya kayan noktalı sayıyı baştaki sıfırlarla sabitleyebilirsiniz.

int value = 16342;
string result = String.Format("{0,18:00000000} {0,18:00000000.000} {0,18:000,0000,000.0}",
                              value);
Console.WriteLine(result);
// The example displays the following output:
//           00016342       00016342.000    0,000,016,342.0

open System

let value = 16342
String.Format("{0,18:00000000} {0,18:00000000.000} {0,18:000,0000,000.0}", value)
|> printfn "%s"
// The example displays the following output:
//           00016342       00016342.000    0,000,016,342.0

Module Example9
    Public Sub Main()
        Dim value As Integer = 16342
        Dim result As String = String.Format("{0,18:00000000} {0,18:00000000.000} {0,18:000,0000,000.0}",
                                           value)
        Console.WriteLine(result)
    End Sub
End Module
' The example displays the following output:
'           00016342       00016342.000    0,000,016,342.0

Biçim listesine kaç öğe ekleyebilirim?

Pratik bir sınır yoktur. yönteminin Format(IFormatProvider, String, Object[]) ikinci parametresi, biçim listeniz olarak sınırlandırılmış liste veya nesne dizisi eklemenize olanak tanıyan özniteliğiyle ParamArrayAttribute etiketlenmiştir.

Sonuç metnine küme ayraçlarını ("{" ve "}") nasıl eklerim?

Örneğin, aşağıdaki yöntem çağrısının FormatException istisnası fırlatmasını nasıl önlersiniz?

result = String.Format("The text has {0} '{' characters and {1} '}' characters.",
                       nOpen, nClose);

let result = 
    String.Format("The text has {0} '{' characters and {1} '}' characters.", nOpen, nClose)

result = String.Format("The text has {0} '{' characters and {1} '}' characters.",
                 nOpen, nClose)

Tek bir açma veya kapatma ayracı her zaman biçim öğesinin başlangıcı veya sonu olarak yorumlanır. Kelimenin tam anlamıyla yorumlanması için kaçış olması gerekir. Aşağıdaki yöntem çağrısında olduğu gibi, "{" ve "}" yerine başka bir küme ayracı ("{{" ve "}}" ekleyerek küme ayracından kaçabilirsiniz:

string result;
int nOpen = 1;
int nClose = 2;
result = String.Format("The text has {0} '{{' characters and {1} '}}' characters.",
                       nOpen, nClose);
Console.WriteLine(result);

let result =
    String.Format("The text has {0} '{{' characters and {1} '}}' characters.", nOpen, nClose)

result = String.Format("The text has {0} '{{' characters and {1} '}}' characters.",
                 nOpen, nClose)

Ancak, kaçış ayraçları bile kolayca yanlış anlaşılır. Aşağıdaki örnekte gösterildiği gibi, küme ayraçlarını biçim listesine eklemenizi ve sonuç dizesine eklemek için biçim öğelerini kullanmanızı öneririz.

string result;
int nOpen = 1;
int nClose = 2;
result = String.Format("The text has {0} '{1}' characters and {2} '{3}' characters.",
                       nOpen, "{", nClose, "}");
Console.WriteLine(result);

let result =
    String.Format("The text has {0} '{1}' characters and {2} '{3}' characters.", nOpen, "{", nClose, "}")

result = String.Format("The text has {0} '{1}' characters and {2} '{3}' characters.",
                 nOpen, "{", nClose, "}")

String.Format yöntemine çağrım neden formatexception oluşturur?

Özel durumun en yaygın nedeni, biçim öğesinin dizininin biçim listesindeki bir nesneye karşılık olmamasıdır. Bu durum genellikle biçim öğelerinin dizinlerini yanlış numaralandırdığınız veya biçim listesine bir nesne eklemeyi unuttuğunu gösterir. Kaçış yapılmadan bir sol veya sağ küme ayracı karakterini dahil etmeye çalışmak da bir FormatException oluşturur. Bazen, özel durum bir yazım hatasının sonucudur; örneğin, tipik bir hata "{" (sol ayraç) yerine "[" (sol köşeli ayraç) yanlış yazmaktır.

Format(System.IFormatProvider,System.String,System.Object[]) yöntemi parametre dizilerini destekliyorsa, dizi kullandığımda kodum neden özel durum oluşturur?

Örneğin, aşağıdaki kod bir FormatException özel durum oluşturur:

Random rnd = new Random();
int[] numbers = new int[4];
int total = 0;
for (int ctr = 0; ctr <= 2; ctr++)
{
    int number = rnd.Next(1001);
    numbers[ctr] = number;
    total += number;
}
numbers[3] = total;
Console.WriteLine($"{numbers} + {1} + {2} = {3}");

open System

let rnd = Random()
let mutable total = 0
let numbers = Array.zeroCreate<int> 4
for i = 0 to 2 do
   let number = rnd.Next 1001
   numbers[i] <- number
   total <- total + number
numbers[3] <- total
Console.WriteLine("{0} + {1} + {2} = {3}", numbers)

Module Example5a
    Public Sub Main()
        Dim rnd As New Random()
        Dim numbers(3) As Integer
        Dim total As Integer = 0
        For ctr = 0 To 2
            Dim number As Integer = rnd.Next(1001)
            numbers(ctr) = number
            total += number
        Next
        numbers(3) = total
        Console.WriteLine("{0} + {1} + {2} = {3}", numbers)
    End Sub
End Module

Bu, derleyici aşırı yükleme çözümlemesi sorunudur. Derleyici bir tamsayı dizisini bir nesne dizisine dönüştüremediğinden, tamsayı dizisini tek bir bağımsız değişken olarak ele alır, bu nedenle yöntemini çağırır Format(String, Object) . Dört biçim öğesi varken, biçim listesinde yalnızca tek bir öğe bulunduğu için özel durum fırlatılır.

Visual Basic veya C# bir tamsayı dizisini nesne dizisine dönüştüremediğinden, yöntemini çağırmadan önce dönüştürmeyi Format(String, Object[]) kendiniz gerçekleştirmeniz gerekir. Aşağıdaki örnek bir uygulama sağlar.

Random rnd = new Random();
int[] numbers = new int[4];
int total = 0;
for (int ctr = 0; ctr <= 2; ctr++)
{
    int number = rnd.Next(1001);
    numbers[ctr] = number;
    total += number;
}
numbers[3] = total;
object[] values = new object[numbers.Length];
numbers.CopyTo(values, 0);
Console.WriteLine($"{values} + {1} + {2} = {3}");

open System

let rnd = Random()
let numbers = Array.zeroCreate<int> 4
let mutable total = 0
for i = 0 to 2 do
   let number = rnd.Next 1001
   numbers[i] <- number
   total <- total + number
numbers[3] <- total
let values = Array.zeroCreate<obj> numbers.Length
numbers.CopyTo(values, 0)
Console.WriteLine("{0} + {1} + {2} = {3}", values)

Imports System.Collections.Generic

Module Example6
    Public Sub Main()
        Dim rnd As New Random()
        Dim numbers(3) As Integer
        Dim total As Integer = 0
        For ctr = 0 To 2
            Dim number As Integer = rnd.Next(1001)
            numbers(ctr) = number
            total += number
        Next
        numbers(3) = total
        Dim values(numbers.Length - 1) As Object
        numbers.CopyTo(values, 0)
        Console.WriteLine("{0} + {1} + {2} = {3}", values)
    End Sub
End Module

Açıklamalar

Important

String.Format yöntemini çağırmak veya bileşik biçim dizelerini kullanmak yerine, diliniz bunları destekliyorsa ilişkilendirilmiş dizeler kullanabilirsiniz. Enterpolasyonlu dize, enterpolasyon ifadeleri içeren bir dizedir. Ara ifade, ifadenin değeriyle çözümlenir ve dize atanırken sonuç dizesine eklenir. Daha fazla bilgi için bkz . Dize ilişkilendirmesi (C# Başvurusu) ve İlişkili Dizeler (Visual Basic Başvurusu).

Format(IFormatProvider, String, Object, Object, Object)

Kaynak:

String.Manipulation.cs

Bir dizedeki biçim öğelerini belirtilen üç nesnenin dize gösterimiyle değiştirir. Parametre kültüre özgü biçimlendirme bilgileri sağlar.

public:
 static System::String ^ Format(IFormatProvider ^ provider, System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);

public static string Format(IFormatProvider? provider, string format, object? arg0, object? arg1, object? arg2);

static member Format : IFormatProvider * string * obj * obj * obj -> string

Public Shared Function Format (provider As IFormatProvider, format As String, arg0 As Object, arg1 As Object, arg2 As Object) As String

Parametreler

provider

IFormatProvider

Kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.

format

String

Bileşik biçim dizesi.

arg0

Object

Biçimlendirecek ilk nesne.

arg1

Object

Biçimlendirecek ikinci nesne.

arg2

Object

Biçimlendirecek üçüncü nesne.

Döndürülenler

String

Biçim öğelerinin format , ve arg0dize gösterimleriyle arg1arg2değiştirildiği bir kopyası.

Özel durumlar

ArgumentNullException

format, null'e eşittir.

FormatException

format geçersiz.

-veya-

Biçim öğesinin dizini sıfırdan küçük veya ikiden büyük.

Açıklamalar

Important

String.Format yöntemini çağırmak veya bileşik biçim dizelerini kullanmak yerine, diliniz bunları destekliyorsa ilişkilendirilmiş dizeler kullanabilirsiniz. Enterpolasyonlu dize, enterpolasyon ifadeleri içeren bir dizedir. Ara ifade, ifadenin değeriyle çözümlenir ve dize atanırken sonuç dizesine eklenir. Daha fazla bilgi için bkz . Dize ilişkilendirmesi (C# Başvurusu) ve İlişkili Dizeler (Visual Basic Başvurusu).

Bu yöntem, üç ifadeyi dize gösterimlerine dönüştürmek ve bu gösterimleri bir dizeye eklemek için bileşik biçimlendirme özelliğini kullanır. Dönüştürmeyi gerçekleştirirken yöntemi kültüre duyarlı biçimlendirmeyi veya özel bir biçimlendiriciyi kullanır. yöntemi, Object yöntemini çağırarak veya nesnenin karşılık gelen biçim öğesi bir biçim dizesi içeriyorsa, ToString(String,IFormatProvider) yöntemini çağırarak her bağımsız değişkeni dize gösterimine dönüştürür. Bu yöntemler yoksa, nesnenin parametresiz ToString yöntemini çağırır.

Ancak yöntemini çağırırken String.Format , çağırmak istediğiniz belirli aşırı yüklemeye odaklanmanız gerekmez. Bunun yerine, yöntemini kültüre duyarlı veya özel biçimlendirme sağlayan bir nesneyle ve bir veya daha fazla biçim öğesi içeren bileşik biçim dizesiyle çağırabilirsiniz. Her biçim öğesine sayısal bir dizin atarsınız; ilk dizin 0'da başlar. İlk dizeye ek olarak, yöntem çağrınızın dizin değerlerine sahip olduğu kadar çok ek bağımsız değişkeni olmalıdır. Örneğin, biçim öğelerinin dizini 0 ve 1 olan bir dizenin 2 bağımsız değişkeni olmalıdır; 0 ile 5 arasında dizinleri olan bir tanesinde 6 bağımsız değişken olmalıdır. Dil derleyicisi daha sonra yönteminizin belirli bir aşırı yüklemesine String.Format çağrınızı çözümler.

yöntemini kullanma String.Format hakkında daha ayrıntılı belgeler için bkz. String.Format yöntemini kullanmaya başlama ve Hangi yöntemi çağırmalıyım?.

Format(IFormatProvider, String, Object, Object)

Kaynak:

String.Manipulation.cs

Bir dizedeki biçim öğelerini belirtilen iki nesnenin dize gösterimiyle değiştirir. Parametre kültüre özgü biçimlendirme bilgileri sağlar.

public:
 static System::String ^ Format(IFormatProvider ^ provider, System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);

public static string Format(IFormatProvider? provider, string format, object? arg0, object? arg1);

static member Format : IFormatProvider * string * obj * obj -> string

Public Shared Function Format (provider As IFormatProvider, format As String, arg0 As Object, arg1 As Object) As String

Parametreler

provider

IFormatProvider

Kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.

format

String

Bileşik biçim dizesi.

arg0

Object

Biçimlendirecek ilk nesne.

arg1

Object

Biçimlendirecek ikinci nesne.

Döndürülenler

String

biçim öğelerinin format ve arg0dize gösterimleriyle arg1 değiştirildiği bir kopyası.

Özel durumlar

ArgumentNullException

format, null'e eşittir.

FormatException

format geçersiz.

-veya-

Biçim öğesinin dizini sıfır veya bir değil.

Açıklamalar

Important

String.Format yöntemini çağırmak veya bileşik biçim dizelerini kullanmak yerine, diliniz bunları destekliyorsa ilişkilendirilmiş dizeler kullanabilirsiniz. Enterpolasyonlu dize, enterpolasyon ifadeleri içeren bir dizedir. Ara ifade, ifadenin değeriyle çözümlenir ve dize atanırken sonuç dizesine eklenir. Daha fazla bilgi için bkz . Dize ilişkilendirmesi (C# Başvurusu) ve İlişkili Dizeler (Visual Basic Başvurusu).

Bu yöntem, iki ifadeyi dize gösterimlerine dönüştürmek ve bu gösterimleri bir dizeye eklemek için bileşik biçimlendirme özelliğini kullanır. Dönüştürmeyi gerçekleştirirken yöntemi kültüre duyarlı biçimlendirmeyi veya özel bir biçimlendiriciyi kullanır. yöntemi, Object yöntemini çağırarak veya nesnenin karşılık gelen biçim öğesi bir biçim dizesi içeriyorsa, ToString(String,IFormatProvider) yöntemini çağırarak her bağımsız değişkeni dize gösterimine dönüştürür. Bu yöntemler yoksa, nesnenin parametresiz ToString yöntemini çağırır.

Ancak yöntemini çağırırken String.Format , çağırmak istediğiniz belirli aşırı yüklemeye odaklanmanız gerekmez. Bunun yerine, yöntemini kültüre duyarlı veya özel biçimlendirme sağlayan bir nesneyle ve bir veya daha fazla biçim öğesi içeren bileşik biçim dizesiyle çağırabilirsiniz. Her biçim öğesine sayısal bir dizin atarsınız; ilk dizin 0'da başlar. İlk dizeye ek olarak, yöntem çağrınızın dizin değerlerine sahip olduğu kadar çok ek bağımsız değişkeni olmalıdır. Örneğin, biçim öğelerinin dizini 0 ve 1 olan bir dizenin 2 bağımsız değişkeni olmalıdır; 0 ile 5 arasında dizinleri olan bir tanesinde 6 bağımsız değişken olmalıdır. Dil derleyicisi daha sonra yönteminizin belirli bir aşırı yüklemesine String.Format çağrınızı çözümler.

yöntemini kullanma String.Format hakkında daha ayrıntılı belgeler için bkz. String.Format yöntemini kullanmaya başlama ve Hangi yöntemi çağırmalıyım?.

Format(String, Object, Object)

Kaynak:

String.Manipulation.cs

Bir dizedeki biçim öğelerini belirtilen iki nesnenin dize gösterimiyle değiştirir.

public:
 static System::String ^ Format(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);

public static string Format(string format, object? arg0, object? arg1);

static member Format : string * obj * obj -> string

Public Shared Function Format (format As String, arg0 As Object, arg1 As Object) As String

Parametreler

format

String

Bileşik biçim dizesi.

arg0

Object

Biçimlendirecek ilk nesne.

arg1

Object

Biçimlendirecek ikinci nesne.

Döndürülenler

String

biçim öğelerinin format ve arg0dize gösterimleriyle arg1 değiştirildiği bir kopyası.

Özel durumlar

ArgumentNullException

format, null'e eşittir.

FormatException

format geçersiz.

-veya-

Biçim öğesinin dizini sıfır veya bir değil.

Açıklamalar

Important

String.Format yöntemini çağırmak veya bileşik biçim dizelerini kullanmak yerine, diliniz bunları destekliyorsa ilişkilendirilmiş dizeler kullanabilirsiniz. Enterpolasyonlu dize, enterpolasyon ifadeleri içeren bir dizedir. Ara ifade, ifadenin değeriyle çözümlenir ve dize atanırken sonuç dizesine eklenir. Daha fazla bilgi için bkz . Dize ilişkilendirmesi (C# Başvurusu) ve İlişkili Dizeler (Visual Basic Başvurusu).

Bu yöntem, iki ifadenin değerini dize gösterimlerine dönüştürmek ve bu gösterimleri bir dizeye eklemek için bileşik biçimlendirme özelliğini kullanır.

Ancak yöntemini çağırırken String.Format , çağırmak istediğiniz belirli aşırı yüklemeye odaklanmanız gerekmez. Bunun yerine, yöntemini bir veya daha fazla biçim öğesi içeren bileşik bir biçim dizesiyle çağırabilirsiniz. Her biçim öğesine sayısal bir dizin atarsınız; ilk dizin 0'da başlar. İlk dizeye ek olarak, yöntem çağrınızın dizin değerlerine sahip olduğu kadar çok ek bağımsız değişkeni olmalıdır. Örneğin, biçim öğelerinin dizini 0 ve 1 olan bir dizenin 2 bağımsız değişkeni olmalıdır; 0 ile 5 arasında dizinleri olan bir tanesinde 6 bağımsız değişken olmalıdır. Dil derleyicisi daha sonra yönteminizin belirli bir aşırı yüklemesine String.Format çağrınızı çözümler.

yöntemini kullanma String.Format hakkında daha ayrıntılı belgeler için bkz. String.Format yöntemini kullanmaya başlama ve Hangi yöntemi çağırmalıyım?.

Örnek: İki bağımsız değişkeni biçimlendirme

Bu örnek, genel Format(String, Object, Object) bir nesnede Dictionary<TKey,TValue> depolanan zaman ve sıcaklık verilerini görüntülemek için yöntemini kullanır. Biçimlendirecek yalnızca iki nesne olmasına rağmen, biçim dizesinin üç biçim öğesi olduğuna dikkat edin. Bunun nedeni listedeki ilk nesnenin (tarih ve saat değeri) iki biçim öğesi tarafından kullanılmasıdır: İlk biçim öğesi saati, ikinci nesne ise tarihi görüntüler.

Dictionary<DateTime, Double> temperatureInfo = new Dictionary<DateTime, Double>();
temperatureInfo.Add(new DateTime(2010, 6, 1, 14, 0, 0), 87.46);
temperatureInfo.Add(new DateTime(2010, 12, 1, 10, 0, 0), 36.81);

Console.WriteLine("Temperature Information:\n");
string output;
foreach (var item in temperatureInfo)
{
   output = String.Format("Temperature at {0,8:t} on {0,9:d}: {1,5:N1}°F",
                          item.Key, item.Value);
   Console.WriteLine(output);
}
// The example displays output like the following:
//       Temperature Information:
//
//       Temperature at  2:00 PM on  6/1/2010:  87.5°F
//       Temperature at 10:00 AM on 12/1/2010:  36.8°F

open System
open System.Collections.Generic

let temperatureInfo = Dictionary<DateTime, float>() 
temperatureInfo.Add(DateTime(2010, 6, 1, 14, 0, 0), 87.46)
temperatureInfo.Add(DateTime(2010, 12, 1, 10, 0, 0), 36.81)

printfn $"Temperature Information:\n"
for item in temperatureInfo do
   String.Format("Temperature at {0,8:t} on {0,9:d}: {1,5:N1}°F", item.Key, item.Value)
   |> printfn "%s"
// The example displays output like the following:
//       Temperature Information:
//       
//       Temperature at  2:00 PM on  6/1/2010:  87.5°F
//       Temperature at 10:00 AM on 12/1/2010:  36.8°F

Imports System.Collections.Generic

Module Example
   Public Sub Main()
      Dim temperatureInfo As New Dictionary(Of Date, Double) 
      temperatureInfo.Add(#6/1/2010 2:00PM#, 87.46)
      temperatureInfo.Add(#12/1/2010 10:00AM#, 36.81)
      
      Console.WriteLine("Temperature Information:")
      Console.WriteLine()
      Dim output As String   
      For Each item In temperatureInfo
         output = String.Format("Temperature at {0,8:t} on {0,9:d}: {1,5:N1}°F", _
                                item.Key, item.Value)
         Console.WriteLine(output)
      Next
   End Sub
End Module
' The example displays the following output:
'       Temperature Information:
'       
'       Temperature at  2:00 PM on  6/1/2010:  87.5°F
'       Temperature at 10:00 AM on 12/1/2010:  36.8°F

Ayrıca bkz.

• .NET'da Biçimlendirme Türleri
• Bileşik Biçimlendirme
• Standart Tarih ve Saat Biçim Dizeleri
• Özel Tarih ve Saat Biçim Dizeleri
• Standart Sayısal Biçim Dizeleri
• Özel Sayısal Biçim Dizeleri
• Standart TimeSpan Biçim Dizeleri
• Özel TimeSpan Biçim Dizeleri
• Numaralandırma Biçim Dizeleri

Format(IFormatProvider, CompositeFormat, ReadOnlySpan<Object>)

Kaynak:

String.Manipulation.cs

içindeki biçim öğesini veya öğelerini CompositeFormat , belirtilen biçimde karşılık gelen nesnelerin dize gösterimiyle değiştirir.

public:
 static System::String ^ Format(IFormatProvider ^ provider, System::Text::CompositeFormat ^ format, ReadOnlySpan<System::Object ^> args);

public static string Format(IFormatProvider? provider, System.Text.CompositeFormat format, scoped ReadOnlySpan<object?> args);

static member Format : IFormatProvider * System.Text.CompositeFormat * ReadOnlySpan<obj> -> string

Public Shared Function Format (provider As IFormatProvider, format As CompositeFormat, args As ReadOnlySpan(Of Object)) As String

Parametreler

provider

IFormatProvider

Kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.

format

CompositeFormat

Bir CompositeFormat.

args

ReadOnlySpan<Object>

Biçimlendirecek nesnelerin yayılma alanı.

Döndürülenler

String

Biçimlendirilmiş dize.

Özel durumlar

ArgumentNullException

format, null'e eşittir.

FormatException

Biçim öğesinin dizini, sağlanan bağımsız değişkenlerin sayısından büyük veya buna eşittir.

Format(IFormatProvider, CompositeFormat, Object[])

Kaynak:

String.Manipulation.cs

içindeki biçim öğesini veya öğelerini CompositeFormat , belirtilen biçimde karşılık gelen nesnelerin dize gösterimiyle değiştirir.

public:
 static System::String ^ Format(IFormatProvider ^ provider, System::Text::CompositeFormat ^ format, ... cli::array <System::Object ^> ^ args);

public static string Format(IFormatProvider? provider, System.Text.CompositeFormat format, params object?[] args);

static member Format : IFormatProvider * System.Text.CompositeFormat * obj[] -> string

Public Shared Function Format (provider As IFormatProvider, format As CompositeFormat, ParamArray args As Object()) As String

Parametreler

provider

IFormatProvider

Kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.

format

CompositeFormat

Bir CompositeFormat.

args

Object[]

Biçimlendirecek nesneler dizisi.

Döndürülenler

String

Biçimlendirilmiş dize.

Özel durumlar

ArgumentNullException

format veya args şeklindedir null.

FormatException

Biçim öğesinin dizini, sağlanan bağımsız değişkenlerin sayısından büyük veya buna eşittir.

Format(String, Object, Object, Object)

Kaynak:

String.Manipulation.cs

Bir dizedeki biçim öğelerini belirtilen üç nesnenin dize gösterimiyle değiştirir.

public:
 static System::String ^ Format(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);

public static string Format(string format, object? arg0, object? arg1, object? arg2);

static member Format : string * obj * obj * obj -> string

Public Shared Function Format (format As String, arg0 As Object, arg1 As Object, arg2 As Object) As String

Parametreler

format

String

Bileşik biçim dizesi.

arg0

Object

Biçimlendirecek ilk nesne.

arg1

Object

Biçimlendirecek ikinci nesne.

arg2

Object

Biçimlendirecek üçüncü nesne.

Döndürülenler

String

Biçim öğelerinin format , ve arg0dize gösterimleriyle arg1arg2değiştirildiği bir kopyası.

Özel durumlar

ArgumentNullException

format, null'e eşittir.

FormatException

format geçersiz.

-veya-

Biçim öğesinin dizini sıfırdan küçük veya ikiden büyük.

Açıklamalar

Important

String.Format yöntemini çağırmak veya bileşik biçim dizelerini kullanmak yerine, diliniz bunları destekliyorsa ilişkilendirilmiş dizeler kullanabilirsiniz. Enterpolasyonlu dize, enterpolasyon ifadeleri içeren bir dizedir. Ara ifade, ifadenin değeriyle çözümlenir ve dize atanırken sonuç dizesine eklenir. Daha fazla bilgi için bkz . Dize ilişkilendirmesi (C# Başvurusu) ve İlişkili Dizeler (Visual Basic Başvurusu).

Bu yöntem, üç ifadenin değerini dize gösterimlerine dönüştürmek ve bu gösterimleri bir dizeye eklemek için bileşik biçimlendirme özelliğini kullanır.

Ancak yöntemini çağırırken String.Format , çağırmak istediğiniz belirli aşırı yüklemeye odaklanmanız gerekmez. Bunun yerine, yöntemini bir veya daha fazla biçim öğesi içeren bileşik bir biçim dizesiyle çağırabilirsiniz. Her biçim öğesine sayısal bir dizin atarsınız; ilk dizin 0'da başlar. İlk dizeye ek olarak, yöntem çağrınızın dizin değerlerine sahip olduğu kadar çok ek bağımsız değişkeni olmalıdır. Örneğin, biçim öğelerinin dizini 0 ve 1 olan bir dizenin 2 bağımsız değişkeni olmalıdır; 0 ile 5 arasında dizinleri olan bir tanesinde 6 bağımsız değişken olmalıdır. Dil derleyicisi daha sonra yönteminizin belirli bir aşırı yüklemesine String.Format çağrınızı çözümler.

yöntemini kullanma String.Format hakkında daha ayrıntılı belgeler için bkz. String.Format yöntemini kullanmaya başlama ve Hangi yöntemi çağırmalıyım?.

Örnek: Üç bağımsız değişkeni biçimlendirme

Bu örnekte, iki tamsayı değerine sahip boole Format(String, Object, Object, Object) işleminin sonucunu gösteren bir dize oluşturmak için yöntemi kullanılırAnd. Biçim dizesinin altı biçim öğesi içerdiğini, ancak yöntemin parametre listesinde yalnızca üç öğe olduğunu unutmayın çünkü her öğe iki farklı şekilde biçimlendirilir.

string formatString = "    {0,10} ({0,8:X8})\n" +
                      "And {1,10} ({1,8:X8})\n" +
                      "  = {2,10} ({2,8:X8})";
int value1 = 16932;
int value2 = 15421;
string result = string.Format(formatString,
                              value1, value2, value1 & value2);
Console.WriteLine(result);

// The example displays the following output:
//                16932 (00004224)
//       And      15421 (00003C3D)
//         =         36 (00000024)

open System

let formatString = 
    "    {0,10} ({0,8:X8})\nAnd {1,10} ({1,8:X8})\n  = {2,10} ({2,8:X8})"

let value1 = 16932
let value2 = 15421
String.Format(formatString, value1, value2, value1 &&& value2)
|> printfn "%s"
// The example displays the following output:
//                16932 (00004224)
//       And      15421 (00003C3D)
//         =         36 (00000024)

Public Module Example
   Public Sub Main()
      Dim formatString As String = "    {0,10} ({0,8:X8})" + vbCrLf +  _
                                   "And {1,10} ({1,8:X8})" + vbCrLf + _
                                   "  = {2,10} ({2,8:X8})"
      Dim value1 As Integer = 16932
      Dim value2 As Integer = 15421
      Dim result As String = String.Format(formatString, _
                                           value1, value2, value1 And value2)
      Console.WriteLine(result)                          
   End Sub
End Module
' The example displays the following output:
'                16932 (00004224)
'       And      15421 (00003C3D)
'         =         36 (00000024)

Ayrıca bkz.

• .NET'da Biçimlendirme Türleri
• Bileşik Biçimlendirme

Format(IFormatProvider, String, Object[])

Kaynak:

String.Manipulation.cs

Bir dizedeki biçim öğelerini, belirtilen dizideki ilgili nesnelerin dize gösterimleriyle değiştirir. Parametre kültüre özgü biçimlendirme bilgileri sağlar.

public:
 static System::String ^ Format(IFormatProvider ^ provider, System::String ^ format, ... cli::array <System::Object ^> ^ args);

public static string Format(IFormatProvider? provider, string format, params object?[] args);

static member Format : IFormatProvider * string * obj[] -> string

Public Shared Function Format (provider As IFormatProvider, format As String, ParamArray args As Object()) As String

Parametreler

provider

IFormatProvider

Kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.

format

String

Bileşik biçim dizesi.

args

Object[]

Biçimlendirecek sıfır veya daha fazla nesne içeren bir nesne dizisi.

Döndürülenler

String

biçim öğelerinin format içindeki karşılık gelen nesnelerin argsdize gösterimiyle değiştirildiği bir kopyası.

Özel durumlar

ArgumentNullException

format veya args şeklindedir null.

FormatException

format geçersiz.

-veya-

Biçim öğesinin dizini sıfırdan küçük veya dizinin uzunluğundan args büyük veya buna eşit.

Açıklamalar

Important

String.Format yöntemini çağırmak veya bileşik biçim dizelerini kullanmak yerine, diliniz bunları destekliyorsa ilişkilendirilmiş dizeler kullanabilirsiniz. Enterpolasyonlu dize, enterpolasyon ifadeleri içeren bir dizedir. Ara ifade, ifadenin değeriyle çözümlenir ve dize atanırken sonuç dizesine eklenir. Daha fazla bilgi için bkz . Dize ilişkilendirmesi (C# Başvurusu) ve İlişkili Dizeler (Visual Basic Başvurusu).

Bu yöntem, dört veya daha fazla ifadeyi dize gösterimlerine dönüştürmek ve bu gösterimleri bir dizeye eklemek için bileşik biçimlendirme özelliğini kullanır. Dönüştürmeyi gerçekleştirirken yöntemi kültüre duyarlı biçimlendirmeyi veya özel bir biçimlendiriciyi kullanır. yöntemi, Object yöntemini çağırarak veya nesnenin karşılık gelen biçim öğesi bir biçim dizesi içeriyorsa, ToString(String,IFormatProvider) yöntemini çağırarak her bağımsız değişkeni dize gösterimine dönüştürür. Bu yöntemler yoksa, nesnenin parametresiz ToString yöntemini çağırır.

Ancak yöntemini çağırırken String.Format , çağırmak istediğiniz belirli aşırı yüklemeye odaklanmanız gerekmez. Bunun yerine, yöntemini kültüre duyarlı veya özel biçimlendirme sağlayan bir nesneyle ve bir veya daha fazla biçim öğesi içeren bileşik biçim dizesiyle çağırabilirsiniz. Her biçim öğesine sayısal bir dizin atarsınız; ilk dizin 0'da başlar. İlk dizeye ek olarak, yöntem çağrınızın dizin değerlerine sahip olduğu kadar çok ek bağımsız değişkeni olmalıdır. Örneğin, biçim öğelerinin dizini 0 ve 1 olan bir dizenin 2 bağımsız değişkeni olmalıdır; 0 ile 5 arasında dizinleri olan bir tanesinde 6 bağımsız değişken olmalıdır. Dil derleyicisi daha sonra yönteminizin belirli bir aşırı yüklemesine String.Format çağrınızı çözümler.

yöntemini kullanma String.Format hakkında daha ayrıntılı belgeler için bkz. String.Format yöntemini kullanmaya başlama ve Hangi yöntemi çağırmalıyım?.

Örnek: Kültüre duyarlı biçimlendirme

Bu örnek, Format(IFormatProvider, String, Object[]) birkaç farklı kültür kullanarak bazı tarih ve saat değerlerinin ve sayısal değerlerin dize gösterimini görüntülemek için yöntemini kullanır.

string[] cultureNames = { "en-US", "fr-FR", "de-DE", "es-ES" };

DateTime dateToDisplay = new DateTime(2009, 9, 1, 18, 32, 0);
double value = 9164.32;

Console.WriteLine("Culture     Date                                Value\n");
foreach (string cultureName in cultureNames)
{
   System.Globalization.CultureInfo culture = new System.Globalization.CultureInfo(cultureName);
   string output = String.Format(culture, "{0,-11} {1,-35:D} {2:N}",
                                 culture.Name, dateToDisplay, value);
   Console.WriteLine(output);
}
// The example displays the following output:
//    Culture     Date                                Value
//
//    en-US       Tuesday, September 01, 2009         9,164.32
//    fr-FR       mardi 1 septembre 2009              9 164,32
//    de-DE       Dienstag, 1. September 2009         9.164,32
//    es-ES       martes, 01 de septiembre de 2009    9.164,32

open System
open System.Globalization

let cultureNames = [| "en-US"; "fr-FR"; "de-DE"; "es-ES" |]

let dateToDisplay = DateTime(2009, 9, 1, 18, 32, 0)
let value = 9164.32

printfn "Culture     Date                                Value\n"
for cultureName in cultureNames do
    let culture = CultureInfo cultureName
    String.Format(culture, "{0,-11} {1,-35:D} {2:N}", culture.Name, dateToDisplay, value)
    |> printfn "%s"
// The example displays the following output:
//    Culture     Date                                Value
//    
//    en-US       Tuesday, September 01, 2009         9,164.32
//    fr-FR       mardi 1 septembre 2009              9 164,32
//    de-DE       Dienstag, 1. September 2009         9.164,32
//    es-ES       martes, 01 de septiembre de 2009    9.164,32

Imports System.Globalization

Module Example2
   Public Sub Main()
      Dim cultureNames() As String = { "en-US", "fr-FR", "de-DE", "es-ES" }

      Dim dateToDisplay As Date = #9/1/2009 6:32PM#
      Dim value As Double = 9164.32

      Console.WriteLine("Culture     Date                                Value")
      Console.WriteLine()
      For Each cultureName As String In cultureNames
         Dim culture As New CultureInfo(cultureName)
         Dim output As String = String.Format(culture, "{0,-11} {1,-35:D} {2:N}", _
                                              culture.Name, dateToDisplay, value)
         Console.WriteLine(output)
      Next
   End Sub
End Module
' The example displays the following output:
'       Culture     Date                                Value
'
'       en-US       Tuesday, September 01, 2009         9,164.32
'       fr-FR       mardi 1 septembre 2009              9 164,32
'       de-DE       Dienstag, 1. September 2009         9.164,32
'       es-ES       martes, 01 de septiembre de 2009    9.164,32

Ayrıca bkz.

• DateTimeFormatInfo
• ICustomFormatter
• IFormatProvider
• NumberFormatInfo
• .NET'da Biçimlendirme Türleri
• Bileşik Biçimlendirme
• Standart Tarih ve Saat Biçim Dizeleri
• Özel Tarih ve Saat Biçim Dizeleri
• Standart Sayısal Biçim Dizeleri
• Özel Sayısal Biçim Dizeleri
• Standart TimeSpan Biçim Dizeleri
• Özel TimeSpan Biçim Dizeleri
• Numaralandırma Biçim Dizeleri

Format(IFormatProvider, String, Object)

Kaynak:

String.Manipulation.cs

Belirtilen dizedeki biçim öğesini veya öğelerini ilgili nesnenin dize gösterimiyle değiştirir. Parametre kültüre özgü biçimlendirme bilgileri sağlar.

public:
 static System::String ^ Format(IFormatProvider ^ provider, System::String ^ format, System::Object ^ arg0);

public static string Format(IFormatProvider? provider, string format, object? arg0);

static member Format : IFormatProvider * string * obj -> string

Public Shared Function Format (provider As IFormatProvider, format As String, arg0 As Object) As String

Parametreler

provider

IFormatProvider

Kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.

format

String

Bileşik biçim dizesi.

arg0

Object

Biçimlendirecek nesne.

Döndürülenler

String

Öğesinin format veya öğelerin biçim öğesinin dize gösterimiyle arg0değiştirildiği kopyası.

Özel durumlar

ArgumentNullException

format, null'e eşittir.

FormatException

format geçersiz.

-veya-

Biçim öğesinin dizini sıfır değil.

Açıklamalar

Important

String.Format yöntemini çağırmak veya bileşik biçim dizelerini kullanmak yerine, diliniz bunları destekliyorsa ilişkilendirilmiş dizeler kullanabilirsiniz. Enterpolasyonlu dize, enterpolasyon ifadeleri içeren bir dizedir. Ara ifade, ifadenin değeriyle çözümlenir ve dize atanırken sonuç dizesine eklenir. Daha fazla bilgi için bkz . Dize ilişkilendirmesi (C# Başvurusu) ve İlişkili Dizeler (Visual Basic Başvurusu).

Bu yöntem, bir ifadenin değerini dize gösterimine dönüştürmek ve bu gösterimi bir dizeye eklemek için bileşik biçimlendirme özelliğini kullanır. Dönüştürmeyi gerçekleştirirken yöntemi kültüre duyarlı biçimlendirmeyi veya özel bir biçimlendiriciyi kullanır. yöntemiarg0 yöntemini çağırarak veya nesnenin karşılık gelen biçim öğesi bir biçim dizesi içeriyorsa, ToString(String,IFormatProvider) yöntemini çağırarak dize gösterimine dönüştürür. Bu yöntemler yoksa, nesnenin parametresiz ToString yöntemini çağırır.

Ancak yöntemini çağırırken String.Format , çağırmak istediğiniz belirli aşırı yüklemeye odaklanmanız gerekmez. Bunun yerine, yöntemini kültüre duyarlı veya özel biçimlendirme sağlayan bir nesneyle ve bir veya daha fazla biçim öğesi içeren bileşik biçim dizesiyle çağırabilirsiniz. Her biçim öğesine sayısal bir dizin atarsınız; ilk dizin 0'da başlar. İlk dizeye ek olarak, yöntem çağrınızın dizin değerlerine sahip olduğu kadar çok ek bağımsız değişkeni olmalıdır. Örneğin, biçim öğelerinin dizini 0 ve 1 olan bir dizenin 2 bağımsız değişkeni olmalıdır; 0 ile 5 arasında dizinleri olan bir tanesinde 6 bağımsız değişken olmalıdır. Dil derleyicisi daha sonra yönteminizin belirli bir aşırı yüklemesine String.Format çağrınızı çözümler.

yöntemini kullanma String.Format hakkında daha ayrıntılı belgeler için bkz. String.Format yöntemini kullanmaya başlama ve Hangi yöntemi çağırmalıyım?.

Format(String, ReadOnlySpan<Object>)

Kaynak:

String.Manipulation.cs

Belirtilen dizedeki biçim öğesini, belirtilen bir yayılma alanında karşılık gelen bir nesnenin dize gösterimiyle değiştirir.

public:
 static System::String ^ Format(System::String ^ format, ReadOnlySpan<System::Object ^> args);

public static string Format(string format, scoped ReadOnlySpan<object?> args);

static member Format : string * ReadOnlySpan<obj> -> string

Public Shared Function Format (format As String, args As ReadOnlySpan(Of Object)) As String

Parametreler

format

String

Bileşik biçim dizesi.

args

ReadOnlySpan<Object>

Biçimlendirecek sıfır veya daha fazla nesne içeren bir nesne aralığı.

Döndürülenler

String

biçim öğelerinin format içindeki karşılık gelen nesnelerin argsdize gösterimiyle değiştirildiği bir kopyası.

Format(String, Object[])

Kaynak:

String.Manipulation.cs

Belirtilen dizedeki biçim öğesini, belirtilen dizideki karşılık gelen bir nesnenin dize gösterimiyle değiştirir.

public:
 static System::String ^ Format(System::String ^ format, ... cli::array <System::Object ^> ^ args);

public static string Format(string format, params object?[] args);

static member Format : string * obj[] -> string

Public Shared Function Format (format As String, ParamArray args As Object()) As String

Parametreler

format

String

Bileşik biçim dizesi.

args

Object[]

Biçimlendirecek sıfır veya daha fazla nesne içeren bir nesne dizisi.

Döndürülenler

String

biçim öğelerinin format içindeki karşılık gelen nesnelerin argsdize gösterimiyle değiştirildiği bir kopyası.

Özel durumlar

ArgumentNullException

format veya args şeklindedir null.

FormatException

format geçersiz.

-veya-

Biçim öğesinin dizini sıfırdan küçük veya dizinin uzunluğundan args büyük veya buna eşit.

Açıklamalar

Important

String.Format yöntemini çağırmak veya bileşik biçim dizelerini kullanmak yerine, diliniz bunları destekliyorsa ilişkilendirilmiş dizeler kullanabilirsiniz. Enterpolasyonlu dize, enterpolasyon ifadeleri içeren bir dizedir. Ara ifade, ifadenin değeriyle çözümlenir ve dize atanırken sonuç dizesine eklenir. Daha fazla bilgi için bkz . Dize ilişkilendirmesi (C# Başvurusu) ve İlişkili Dizeler (Visual Basic Başvurusu).

Bu yöntem, dört veya daha fazla ifadenin değerini dize gösterimlerine dönüştürmek ve bu gösterimleri bir dizeye eklemek için bileşik biçimlendirme özelliğini kullanır. args parametresi özniteliğiyle System.ParamArrayAttribute işaretlendiğinden, nesneleri tek bağımsız değişken veya dizi Object olarak yöntemine geçirebilirsiniz.

Ancak yöntemini çağırırken String.Format , çağırmak istediğiniz belirli aşırı yüklemeye odaklanmanız gerekmez. Bunun yerine, yöntemini bir veya daha fazla biçim öğesi içeren bileşik bir biçim dizesiyle çağırabilirsiniz. Her biçim öğesine sayısal bir dizin atarsınız; ilk dizin 0'da başlar. İlk dizeye ek olarak, yöntem çağrınızın dizin değerlerine sahip olduğu kadar çok ek bağımsız değişkeni olmalıdır. Örneğin, biçim öğelerinin dizini 0 ve 1 olan bir dizenin 2 bağımsız değişkeni olmalıdır; 0 ile 5 arasında dizinleri olan bir tanesinde 6 bağımsız değişken olmalıdır. Dil derleyicisi daha sonra yönteminizin belirli bir aşırı yüklemesine String.Format çağrınızı çözümler.

yöntemini kullanma String.Format hakkında daha ayrıntılı belgeler için bkz. String.Format yöntemini kullanmaya başlama ve Hangi yöntemi çağırmalıyım?.

Örnek: Üçten fazla bağımsız değişkeni biçimlendirme

Bu örnek, belirli bir tarihteki yüksek ve düşük sıcaklık verilerini içeren bir dize oluşturur. Bileşik biçim dizesinin C# örneğinde beş, Visual Basic örneğinde altı biçim öğesi vardır. Biçim öğelerinin ikisi, karşılık gelen değerlerin dize gösteriminin genişliğini tanımlar ve ilk biçim öğesi de standart bir tarih ve saat biçim dizesi içerir.

DateTime date1 = new DateTime(2009, 7, 1);
TimeSpan hiTime = new TimeSpan(14, 17, 32);
decimal hiTemp = 62.1m;
TimeSpan loTime = new TimeSpan(3, 16, 10);
decimal loTemp = 54.8m;

string result1 = String.Format("Temperature on {0:d}:\n{1,11}: {2} degrees (hi)\n{3,11}: {4} degrees (lo)",
                               date1, hiTime, hiTemp, loTime, loTemp);
Console.WriteLine(result1);
Console.WriteLine();

string result2 = String.Format("Temperature on {0:d}:\n{1,11}: {2} degrees (hi)\n{3,11}: {4} degrees (lo)",
                               new object[] { date1, hiTime, hiTemp, loTime, loTemp });
Console.WriteLine(result2);
// The example displays output like the following:
//       Temperature on 7/1/2009:
//          14:17:32: 62.1 degrees (hi)
//          03:16:10: 54.8 degrees (lo)
//       Temperature on 7/1/2009:
//          14:17:32: 62.1 degrees (hi)
//          03:16:10: 54.8 degrees (lo)

let date1 = DateTime(2009, 7, 1)
let hiTime = TimeSpan(14, 17, 32)
let hiTemp = 62.1m 
let loTime = TimeSpan(3, 16, 10)
let loTemp = 54.8m 

String.Format("Temperature on {0:d}:\n{1,11}: {2} degrees (hi)\n{3,11}: {4} degrees (lo)", date1, hiTime, hiTemp, loTime, loTemp)
|> printfn "%s\n"
      
String.Format("Temperature on {0:d}:\n{1,11}: {2} degrees (hi)\n{3,11}: {4} degrees (lo)", [| date1 :> obj; hiTime; hiTemp; loTime; loTemp |])
|> printfn "%s"
// The example displays output like the following:
//       Temperature on 7/1/2009:
//          14:17:32: 62.1 degrees (hi)
//          03:16:10: 54.8 degrees (lo)
//       Temperature on 7/1/2009:
//          14:17:32: 62.1 degrees (hi)
//          03:16:10: 54.8 degrees (lo)

Module Example
   Public Sub Main()
      Dim date1 As Date = #7/1/2009#
      Dim hiTime As New TimeSpan(14, 17, 32)
      Dim hiTemp As Decimal = 62.1d 
      Dim loTime As New TimeSpan(3, 16, 10)
      Dim loTemp As Decimal = 54.8d 

      Dim result1 As String = String.Format("Temperature on {0:d}:{5}{1,11}: {2} degrees (hi){5}{3,11}: {4} degrees (lo)", _
                                           date1, hiTime, hiTemp, loTime, loTemp, vbCrLf)
      Console.WriteLine(result1)
      Console.WriteLine()
           
      Dim result2 As String = String.Format("Temperature on {0:d}:{5}{1,11}: {2} degrees (hi){5}{3,11}: {4} degrees (lo)", _
                                            New Object() { date1, hiTime, hiTemp, loTime, loTemp, vbCrLf })
      Console.WriteLine(result2)                                            
   End Sub
End Module
' The example displays the following output:
'       Temperature on 7/1/2009:
'          14:17:32: 62.1 degrees (hi)
'          03:16:10: 54.8 degrees (lo)
'
'       Temperature on 7/1/2009:
'          14:17:32: 62.1 degrees (hi)
'          03:16:10: 54.8 degrees (lo)

Ayrıca, biçimlendirilmiş nesneleri bağımsız değişken listesi yerine dizi olarak geçirebilirsiniz.

using System;

public class CityInfo
{
   public CityInfo(String name, int population, Decimal area, int year)
   {
      this.Name = name;
      this.Population = population;
      this.Area = area;
      this.Year = year;
   }
   
   public readonly String Name; 
   public readonly int Population;
   public readonly Decimal Area;
   public readonly int Year;
}

public class FormatExample10
{
   public static void Main()
   {
      CityInfo nyc2010 = new CityInfo("New York", 8175133, 302.64m, 2010);
      ShowPopulationData(nyc2010);
      CityInfo sea2010 = new CityInfo("Seattle", 608660, 83.94m, 2010);      
      ShowPopulationData(sea2010); 
   }

   private static void ShowPopulationData(CityInfo city)
   {
      object[] args = { city.Name, city.Year, city.Population, city.Area };
      String result = String.Format("{0} in {1}: Population {2:N0}, Area {3:N1} sq. feet", 
                                    args);
      Console.WriteLine(result); 
   }
}
// The example displays the following output:
//       New York in 2010: Population 8,175,133, Area 302.6 sq. feet
//       Seattle in 2010: Population 608,660, Area 83.9 sq. feet

open System

type CityInfo =
  { Name: string
    Population: int
    Area: Decimal
    Year: int }

let showPopulationData city =
    let args: obj[] = [| city.Name; city.Year; city.Population; city.Area |]
    String.Format("{0} in {1}: Population {2:N0}, Area {3:N1} sq. feet", args)
    |> printfn "%s"

{ Name = "New York"; Population = 8175133; Area = 302.64m; Year = 2010 }
|> showPopulationData

 
{ Name = "Seattle"; Population = 608660; Area = 83.94m; Year = 2010 }      
|> showPopulationData 

// The example displays the following output:
//       New York in 2010: Population 8,175,133, Area 302.6 sq. feet
//       Seattle in 2010: Population 608,660, Area 83.9 sq. feet

Public Class CityInfo
   Public Sub New(name As String, population As Integer, area As Decimal, year As Integer)
      Me.Name = name
      Me.Population = population
      Me.Area = area
      Me.Year = year
   End Sub
   
   Public ReadOnly Name As String
   Public ReadOnly Population As Integer
   Public ReadOnly Area As Decimal
   Public ReadOnly Year As Integer
End Class

Module Example
   Public Sub Main()
      Dim nyc2010 As New CityInfo("New York", 8175133, 302.64d, 2010)
      ShowPopulationData(nyc2010)
      Dim sea2010 As New CityInfo("Seattle", 608660, 83.94d, 2010)      
      ShowPopulationData(sea2010) 
   End Sub
   
   Private Sub ShowPopulationData(city As CityInfo)
      Dim args() As Object = { city.Name, city.Year, city.Population, city.Area }
      Dim result = String.Format("{0} in {1}: Population {2:N0}, Area {3:N1} sq. feet", args)
      Console.WriteLine(result) 
   End Sub
End Module
' The example displays the following output:
'       New York in 2010: Population 8,175,133, Area 302.6 sq. feet
'       Seattle in 2010: Population 608,660, Area 83.9 sq. feet

Ayrıca bkz.

• .NET'da Biçimlendirme Türleri
• Bileşik Biçimlendirme
• Standart Tarih ve Saat Biçim Dizeleri
• Özel Tarih ve Saat Biçim Dizeleri
• Standart Sayısal Biçim Dizeleri
• Özel Sayısal Biçim Dizeleri
• Standart TimeSpan Biçim Dizeleri
• Özel TimeSpan Biçim Dizeleri
• Numaralandırma Biçim Dizeleri

Format(String, Object)

Kaynak:

String.Manipulation.cs

Bir dizedeki bir veya daha fazla biçim öğesini belirtilen nesnenin dize gösterimiyle değiştirir.

public:
 static System::String ^ Format(System::String ^ format, System::Object ^ arg0);

public static string Format(string format, object? arg0);

static member Format : string * obj -> string

Public Shared Function Format (format As String, arg0 As Object) As String

Parametreler

format

String

Bileşik biçim dizesi.

arg0

Object

Biçimlendirecek nesne.

Döndürülenler

String

Herhangi bir biçim öğesinin format dize gösterimiyle arg0değiştirildiği bir kopyası.

Özel durumlar

ArgumentNullException

format, null'e eşittir.

FormatException

içindeki format biçim öğesi geçersiz.

-veya-

Biçim öğesinin dizini sıfır değil.

Açıklamalar

Important

String.Format yöntemini çağırmak veya bileşik biçim dizelerini kullanmak yerine, diliniz bunları destekliyorsa ilişkilendirilmiş dizeler kullanabilirsiniz. Enterpolasyonlu dize, enterpolasyon ifadeleri içeren bir dizedir. Ara ifade, ifadenin değeriyle çözümlenir ve dize atanırken sonuç dizesine eklenir. Daha fazla bilgi için bkz . Dize ilişkilendirmesi (C# Başvurusu) ve İlişkili Dizeler (Visual Basic Başvurusu).

Bu yöntem, bir ifadenin değerini dize gösterimine dönüştürmek ve bu gösterimi bir dizeye eklemek için bileşik biçimlendirme özelliğini kullanır.

Ancak yöntemini çağırırken String.Format , çağırmak istediğiniz belirli aşırı yüklemeye odaklanmanız gerekmez. Bunun yerine, yöntemini bir veya daha fazla biçim öğesi içeren bileşik bir biçim dizesiyle çağırabilirsiniz. Her biçim öğesine sayısal bir dizin atarsınız; ilk dizin 0'da başlar. İlk dizeye ek olarak, yöntem çağrınızın dizin değerlerine sahip olduğu kadar çok ek bağımsız değişkeni olmalıdır. Örneğin, biçim öğelerinin dizini 0 ve 1 olan bir dizenin 2 bağımsız değişkeni olmalıdır; 0 ile 5 arasında dizinleri olan bir tanesinde 6 bağımsız değişken olmalıdır. Dil derleyicisi daha sonra yönteminizin belirli bir aşırı yüklemesine String.Format çağrınızı çözümler.

yöntemini kullanma String.Format hakkında daha ayrıntılı belgeler için bkz. String.Format yöntemini kullanmaya başlama ve Hangi yöntemi çağırmalıyım?.

Örnek: Tek bir bağımsız değişkeni biçimlendirme

Aşağıdaki örnek, bir bireyin yaşını dizenin ortasına eklemek için yöntemini kullanır Format(String, Object) .

DateTime birthdate = new DateTime(1993, 7, 28);
DateTime[] dates = { new DateTime(1993, 8, 16),
                     new DateTime(1994, 7, 28),
                     new DateTime(2000, 10, 16),
                     new DateTime(2003, 7, 27),
                     new DateTime(2007, 5, 27) };

foreach (DateTime dateValue in dates)
{
   TimeSpan interval = dateValue - birthdate;
   // Get the approximate number of years, without accounting for leap years.
   int years = ((int) interval.TotalDays) / 365;
   // See if adding the number of years exceeds dateValue.
   string output;
   if (birthdate.AddYears(years) <= dateValue) {
      output = String.Format("You are now {0} years old.", years);
      Console.WriteLine(output);
   }
   else {
      output = String.Format("You are now {0} years old.", years - 1);
      Console.WriteLine(output);
   }
}
// The example displays the following output:
//       You are now 0 years old.
//       You are now 1 years old.
//       You are now 7 years old.
//       You are now 9 years old.
//       You are now 13 years old.

let birthdate = DateTime(1993, 7, 28)
let dates = 
    [ DateTime(1993, 8, 16) 
      DateTime(1994, 7, 28)
      DateTime(2000, 10, 16)
      DateTime(2003, 7, 27)
      DateTime(2007, 5, 27) ]

for dateValue in dates do
    let interval = dateValue - birthdate
    // Get the approximate number of years, without accounting for leap years.
    let years = (int interval.TotalDays) / 365
    // See if adding the number of years exceeds dateValue.
    if birthdate.AddYears years <= dateValue then
        String.Format("You are now {0} years old.", years)
    else
        String.Format("You are now {0} years old.", years - 1)
    |> printfn "%s"
// The example displays the following output:
//       You are now 0 years old.
//       You are now 1 years old.
//       You are now 7 years old.
//       You are now 9 years old.
//       You are now 13 years old.

Module Example
   Public Sub Main()
      Dim birthdate As Date = #7/28/1993#
      Dim dates() As Date = { #9/16/1993#, #7/28/1994#, #10/16/2000#, _
                              #7/27/2003#, #5/27/2007# }
      For Each dateValue As Date In dates
         Dim interval As TimeSpan = dateValue - birthdate
         ' Get the approximate number of years, without accounting for leap years.
         Dim years As Integer = CInt(interval.TotalDays) \ 365
         ' See if adding the number of years exceeds dateValue.
         Dim output As String
         If birthdate.AddYears(years) <= dateValue Then
            output = String.Format("You are now {0} years old.", years)
            Console.WriteLine(output)
         Else
            output = String.Format("You are now {0} years old.", years - 1)
            Console.WriteLine(output)   
         End If
      Next
   End Sub
End Module
' The example displays the following output:
'       You are now 0 years old.
'       You are now 1 years old.
'       You are now 7 years old.
'       You are now 9 years old.
'       You are now 13 years old.

Ayrıca bkz.

• .NET'da Biçimlendirme Türleri
• Bileşik Biçimlendirme
• Standart Tarih ve Saat Biçim Dizeleri
• Özel Tarih ve Saat Biçim Dizeleri
• Standart Sayısal Biçim Dizeleri
• Özel Sayısal Biçim Dizeleri
• Standart TimeSpan Biçim Dizeleri
• Özel TimeSpan Biçim Dizeleri
• Numaralandırma Biçim Dizeleri

Format(IFormatProvider, String, ReadOnlySpan<Object>)

Kaynak:

String.Manipulation.cs

Bir dizedeki biçim öğelerini, belirtilen bir yayılma alanında karşılık gelen nesnelerin dize gösterimleriyle değiştirir. Parametre kültüre özgü biçimlendirme bilgileri sağlar.

public:
 static System::String ^ Format(IFormatProvider ^ provider, System::String ^ format, ReadOnlySpan<System::Object ^> args);

public static string Format(IFormatProvider? provider, string format, scoped ReadOnlySpan<object?> args);

static member Format : IFormatProvider * string * ReadOnlySpan<obj> -> string

Public Shared Function Format (provider As IFormatProvider, format As String, args As ReadOnlySpan(Of Object)) As String

Parametreler

provider

IFormatProvider

Kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.

format

String

Bileşik biçim dizesi.

args

ReadOnlySpan<Object>

Biçimlendirecek sıfır veya daha fazla nesne içeren bir nesne aralığı.

Döndürülenler

String

biçim öğelerinin format içindeki karşılık gelen nesnelerin argsdize gösterimiyle değiştirildiği bir kopyası.

Format<TArg0,TArg1,TArg2>(IFormatProvider, CompositeFormat, TArg0, TArg1, TArg2)

Kaynak:

String.Manipulation.cs

içindeki biçim öğesini veya öğelerini CompositeFormat , belirtilen biçimde karşılık gelen nesnelerin dize gösterimiyle değiştirir.

public:
generic <typename TArg0, typename TArg1, typename TArg2>
 static System::String ^ Format(IFormatProvider ^ provider, System::Text::CompositeFormat ^ format, TArg0 arg0, TArg1 arg1, TArg2 arg2);

public static string Format<TArg0,TArg1,TArg2>(IFormatProvider? provider, System.Text.CompositeFormat format, TArg0 arg0, TArg1 arg1, TArg2 arg2);

static member Format : IFormatProvider * System.Text.CompositeFormat * 'TArg0 * 'TArg1 * 'TArg2 -> string

Public Shared Function Format(Of TArg0, TArg1, TArg2) (provider As IFormatProvider, format As CompositeFormat, arg0 As TArg0, arg1 As TArg1, arg2 As TArg2) As String

Tür Parametreleri

TArg0

Biçimlendirecek ilk nesnenin türü.

TArg1

Biçimlendirecek ikinci nesnenin türü.

TArg2

Biçimlendirecek üçüncü nesnenin türü.

Parametreler

provider

IFormatProvider

Kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.

format

CompositeFormat

Bir CompositeFormat.

arg0

TArg0

Biçimlendirecek ilk nesne.

arg1

TArg1

Biçimlendirecek ikinci nesne.

arg2

TArg2

Biçimlendirecek üçüncü nesne.

Döndürülenler

String

Biçimlendirilmiş dize.

Özel durumlar

ArgumentNullException

format, null'e eşittir.

FormatException

Biçim öğesinin dizini, sağlanan bağımsız değişkenlerin sayısından büyük veya buna eşittir.

Format<TArg0,TArg1>(IFormatProvider, CompositeFormat, TArg0, TArg1)

Kaynak:

String.Manipulation.cs

içindeki biçim öğesini veya öğelerini CompositeFormat , belirtilen biçimde karşılık gelen nesnelerin dize gösterimiyle değiştirir.

public:
generic <typename TArg0, typename TArg1>
 static System::String ^ Format(IFormatProvider ^ provider, System::Text::CompositeFormat ^ format, TArg0 arg0, TArg1 arg1);

public static string Format<TArg0,TArg1>(IFormatProvider? provider, System.Text.CompositeFormat format, TArg0 arg0, TArg1 arg1);

static member Format : IFormatProvider * System.Text.CompositeFormat * 'TArg0 * 'TArg1 -> string

Public Shared Function Format(Of TArg0, TArg1) (provider As IFormatProvider, format As CompositeFormat, arg0 As TArg0, arg1 As TArg1) As String

Tür Parametreleri

TArg0

Biçimlendirecek ilk nesnenin türü.

TArg1

Biçimlendirecek ikinci nesnenin türü.

Parametreler

provider

IFormatProvider

Kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.

format

CompositeFormat

Bir CompositeFormat.

arg0

TArg0

Biçimlendirecek ilk nesne.

arg1

TArg1

Biçimlendirecek ikinci nesne.

Döndürülenler

String

Biçimlendirilmiş dize.

Özel durumlar

ArgumentNullException

format, null'e eşittir.

FormatException

Biçim öğesinin dizini, sağlanan bağımsız değişkenlerin sayısından büyük veya buna eşittir.

Format<TArg0>(IFormatProvider, CompositeFormat, TArg0)

Kaynak:

String.Manipulation.cs

içindeki biçim öğesini veya öğelerini CompositeFormat , belirtilen biçimde karşılık gelen nesnelerin dize gösterimiyle değiştirir.

public:
generic <typename TArg0>
 static System::String ^ Format(IFormatProvider ^ provider, System::Text::CompositeFormat ^ format, TArg0 arg0);

public static string Format<TArg0>(IFormatProvider? provider, System.Text.CompositeFormat format, TArg0 arg0);

static member Format : IFormatProvider * System.Text.CompositeFormat * 'TArg0 -> string

Public Shared Function Format(Of TArg0) (provider As IFormatProvider, format As CompositeFormat, arg0 As TArg0) As String

Tür Parametreleri

TArg0

Biçimlendirecek ilk nesnenin türü.

Parametreler

provider

IFormatProvider

Kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.

format

CompositeFormat

Bir CompositeFormat.

arg0

TArg0

Biçimlendirecek ilk nesne.

Döndürülenler

String

Biçimlendirilmiş dize.

Özel durumlar

ArgumentNullException

format, null'e eşittir.

FormatException

Biçim öğesinin dizini, sağlanan bağımsız değişkenlerin sayısından büyük veya buna eşittir.