İngilizce dilinde oku

Aracılığıyla paylaş


Decimal.ToString Yöntem

Tanım

Bu örneğin sayısal değerini eşdeğer String gösterimine dönüştürür.

Aşırı Yüklemeler

ToString()

Bu örneğin sayısal değerini eşdeğer dize gösterimine dönüştürür.

ToString(IFormatProvider)

Bu örneğin sayısal değerini belirtilen kültüre özgü biçim bilgilerini kullanarak eşdeğer dize gösterimine dönüştürür.

ToString(String)

Bu örneğin sayısal değerini, belirtilen biçimi kullanarak eşdeğer dize gösterimine dönüştürür.

ToString(String, IFormatProvider)

Bu örneğin sayısal değerini belirtilen biçim ve kültüre özgü biçim bilgilerini kullanarak eşdeğer dize gösterimine dönüştürür.

ToString()

Kaynak:
Decimal.cs
Kaynak:
Decimal.cs
Kaynak:
Decimal.cs

Bu örneğin sayısal değerini eşdeğer dize gösterimine dönüştürür.

C#
public override string ToString ();

Döndürülenler

Bu örneğin değerini temsil eden bir dize.

Örnekler

Aşağıdaki örnek, varsayılan ToString() yöntemi kullanarak bir Decimal değer görüntüler. Ayrıca, bir dizi standart biçim belirticisinin kullanılmasından kaynaklanan değerin dize gösterimlerini Decimal görüntüler.

C#
decimal value = -16325.62m;
// Display value using default ToString method.
Console.WriteLine(value.ToString());            // Displays -16325.62
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"));         // Displays -16325.62
Console.WriteLine(value.ToString("C"));         // Displays ($16,325.62)
Console.WriteLine(value.ToString("F"));         // Displays -16325.62

Aşağıdaki örnekte bir hesaptaki para miktarı gösterilir.

C#
class PiggyBank {
    public void AddPenny() {
        MyFortune = Decimal.Add(MyFortune, .01m);
    }

    public override string ToString() {
        return MyFortune.ToString("C")+" in piggy bank";
    }

    protected decimal MyFortune;
}

Açıklamalar

yöntemi, ToString() bir Decimal değeri geçerli kültürün varsayılan ("G" veya genel) biçiminde biçimlendirir. Farklı bir biçim veya kültür belirtmek istiyorsanız yönteminin diğer aşırı yüklemelerini ToString aşağıdaki gibi kullanın:

Biçimi kullanmak için Kültür için Aşırı yüklemeyi kullanma
Varsayılan ("G") biçimi Belirli bir kültür ToString(IFormatProvider)
Belirli bir biçim Varsayılan (geçerli) kültür ToString(String)
Belirli bir biçim Belirli bir kültür ToString(String, IFormatProvider)

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

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(IFormatProvider)

Kaynak:
Decimal.cs
Kaynak:
Decimal.cs
Kaynak:
Decimal.cs

Bu örneğin sayısal değerini belirtilen kültüre özgü biçim bilgilerini kullanarak eşdeğer dize gösterimine dönüştürür.

C#
public string ToString (IFormatProvider provider);
C#
public string ToString (IFormatProvider? provider);

Parametreler

provider
IFormatProvider

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

Döndürülenler

tarafından providerbelirtilen bu örneğin değerinin dize gösterimi.

Uygulamalar

Örnekler

Aşağıdaki örnek, birkaç farklı kültürü temsil eden nesneleri kullanarak CultureInfo bir Decimal değerin dize gösterimini görüntüler.

C#
decimal value = -16325.62m;
// Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture));
// Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")));
// Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")));
// This example displays the following output to the console:
//       -16325.62
//       -16325.62
//       -16325,62

Açıklamalar

yöntemi, ToString(IFormatProvider) bir Decimal değeri belirtilen kültürün varsayılan ("G" veya genel) biçiminde biçimlendirir. Farklı bir biçim veya geçerli kültür belirtmek istiyorsanız yöntemin diğer aşırı yüklemelerini ToString aşağıdaki gibi kullanın:

Biçimi kullanmak için Kültür için Aşırı yüklemeyi kullanma
Varsayılan ("G") biçimi Varsayılan (geçerli) kültür ToString()
Belirli bir biçim Varsayılan (geçerli) kültür ToString(String)
Belirli bir biçim Belirli bir kültür ToString(String, IFormatProvider)

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

provider parametresi, yöntemi bir nesnesi döndüren IFormatProvider.GetFormat bir IFormatProviderNumberFormatInfo uygulamadır. Genellikle bir providerNumberFormatInfo nesne veya nesnedir CultureInfo . provider parametresi, biçimlendirmede kullanılan kültüre özgü bilgiler sağlar. ise providernull, iş parçacığı geçerli kültürü kullanılır.

Belirli bir kültürü ve belirli bir biçim dizesini kullanarak bir Decimal değeri dize gösterimine dönüştürmek için yöntemini çağırın Decimal.ToString(String, IFormatProvider) .

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(String)

Kaynak:
Decimal.cs
Kaynak:
Decimal.cs
Kaynak:
Decimal.cs

Bu örneğin sayısal değerini, belirtilen biçimi kullanarak eşdeğer dize gösterimine dönüştürür.

C#
public string ToString (string format);
C#
public string ToString (string? format);

Parametreler

format
String

Standart veya özel sayısal biçim dizesi.

Döndürülenler

tarafından formatbelirtilen bu örneğin değerinin dize gösterimi.

Özel durumlar

format geçersizdir.

Örnekler

Aşağıdaki örnek, desteklenen standart sayısal biçim tanımlayıcılarının her birini ve iki özel sayısal biçim dizesini kullanan bir Decimal değer görüntüler. Örnek, sayısal değerleri dizelere dönüştürmek için İngilizce (ABD) kültürünün biçimlendirme kurallarını kullanır.

C#
decimal value = 16325.62m;
string specifier;

// Use standard numeric format specifiers.
specifier = "G";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    G: 16325.62
specifier = "C";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    C: $16,325.62
specifier = "E04";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    E04: 1.6326E+004
specifier = "F";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    F: 16325.62
specifier = "N";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    N: 16,325.62
specifier = "P";
Console.WriteLine("{0}: {1}", specifier, (value/10000).ToString(specifier));
// Displays:    P: 163.26 %

// Use custom numeric format specifiers.
specifier = "0,0.000";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    0,0.000: 16,325.620
specifier = "#,#.00#;(#,#.00#)";
Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier));
// Displays:    #,#.00#;(#,#.00#): (16,325.62)

Açıklamalar

yöntemi, ToString(String) geçerli kültürün kurallarını kullanarak değeri Decimal belirtilen biçimde biçimlendirmektedir. Varsayılan ("G" veya genel) biçimini kullanmak veya farklı bir kültür belirtmek istiyorsanız, aşağıdaki gibi yöntemin ToString diğer aşırı yüklemelerini kullanın:

Biçimi kullanmak için Kültür için Aşırı yüklemeyi kullanma
Varsayılan ("G") biçimi Varsayılan (geçerli) kültür ToString()
Varsayılan ("G") biçimi Belirli bir kültür ToString(IFormatProvider)
Belirli bir biçim Belirli bir kültür ToString(String, IFormatProvider)

yöntemi, ToString geçerli örneğin değerini dize gösterimine dönüştürmek için parametresi tarafından format belirtilen standart veya özel sayısal biçim dizesini kullanır. format parametresi, D, R ve X dışında geçerli herhangi bir standart sayısal biçim belirticisi olabileceği gibi, özel sayısal biçim tanımlayıcılarının herhangi bir bileşimi de olabilir. null ise veya boş bir dizeyseformat, bu örneğin dönüş değeri genel sayısal biçim tanımlayıcısı (G) ile biçimlendirilir.

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

Dönüş değeri, geçerli kültür için nesnesi kullanılarak NumberFormatInfo biçimlendirilir. Belirtilen kültürün biçimlendirme kurallarını uygulamak için yöntemini çağırın ToString(String, IFormatProvider) .

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(String, IFormatProvider)

Kaynak:
Decimal.cs
Kaynak:
Decimal.cs
Kaynak:
Decimal.cs

Bu örneğin sayısal değerini belirtilen biçim ve kültüre özgü biçim bilgilerini kullanarak eşdeğer dize gösterimine dönüştürür.

C#
public string ToString (string format, IFormatProvider provider);
C#
public string ToString (string? format, IFormatProvider? provider);

Parametreler

format
String

Bir sayısal biçim dizesi.

provider
IFormatProvider

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

Döndürülenler

ve providertarafından format belirtilen bu örneğin değerinin dize gösterimi.

Uygulamalar

Özel durumlar

format geçersizdir.

Örnekler

Aşağıdaki örnekte, birkaç farklı kültür için desteklenen standart sayısal biçim tanımlayıcılarının her birini kullanan bir Decimal değer görüntülenir.

C#
decimal value = 16325.62m;
string specifier;
CultureInfo culture;

// Use standard numeric format specifiers.
specifier = "G";
culture = CultureInfo.CreateSpecificCulture("eu-ES");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325,62
Console.WriteLine(value.ToString(specifier, CultureInfo.InvariantCulture));
// Displays:    16325.62

specifier = "C";
culture = CultureInfo.CreateSpecificCulture("en-US");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    $16,325.62
culture = CultureInfo.CreateSpecificCulture("en-GB");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    £16,325.62

specifier = "E04";
culture = CultureInfo.CreateSpecificCulture("sv-SE");
Console.WriteLine(value.ToString(specifier, culture));
// Displays: 1,6326E+004
 culture = CultureInfo.CreateSpecificCulture("en-NZ");
 Console.WriteLine(value.ToString(specifier, culture));
// Displays:    1.6326E+004

specifier = "F";
culture = CultureInfo.CreateSpecificCulture("fr-FR");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325,62
culture = CultureInfo.CreateSpecificCulture("en-CA");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325.62

specifier = "N";
culture = CultureInfo.CreateSpecificCulture("es-ES");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16.325,62
culture = CultureInfo.CreateSpecificCulture("fr-CA");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16 325,62

specifier = "P";
culture = CultureInfo.InvariantCulture;
Console.WriteLine((value/10000).ToString(specifier, culture));
// Displays:    163.26 %
culture = CultureInfo.CreateSpecificCulture("ar-EG");
Console.WriteLine((value/10000).ToString(specifier, culture));
// Displays:    163.256 %

Açıklamalar

yöntemi, ToString(String, IFormatProvider) bir Decimal değeri belirtilen kültür biçiminde biçimlendirer. Varsayılan biçim veya kültür ayarlarını kullanmak istiyorsanız yöntemin diğer aşırı yüklemelerini ToString aşağıdaki gibi kullanın:

Biçimi kullanmak için Kültür için Aşırı yüklemeyi kullanma
Varsayılan ("G") biçimi Varsayılan (geçerli) kültür ToString()
Varsayılan ("G") biçimi Belirli bir kültür ToString(IFormatProvider)
Belirli bir biçim Varsayılan (geçerli) kültür ToString(String)

format parametresi, D, R ve X dışında herhangi bir geçerli standart sayısal biçim belirticisinin yanı sıra özel sayısal biçim tanımlayıcılarının herhangi bir bileşimi olabilir. ise null veya boş bir dizeyseformat, bu örneğin dönüş değeri genel sayısal biçim tanımlayıcısı ("G") ile biçimlendirilir.

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

provider parametresi, yöntemi bir nesnesi döndüren IFormatProvider.GetFormat bir IFormatProviderNumberFormatInfo uygulamadır. Genellikle bir providerNumberFormatInfo veya CultureInfo nesnesidir. provider parametresi, biçimlendirmede kullanılan kültüre özgü bilgiler sağlar. ise providernull, iş parçacığı geçerli kültürü kullanılır.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0