BigInteger.ToString Yöntem

Tanım

Ad Alanı:

System.Numerics

Bütünleştirilmiş Kod:

System.Runtime.Numerics.dll

Geçerli BigInteger nesnenin sayısal değerini eşdeğer dize gösterimine dönüştürür.

Aşırı Yüklemeler

ToString(String, IFormatProvider)	Belirtilen biçimi ve kültüre özgü biçim bilgilerini kullanarak geçerli BigInteger nesnenin sayısal değerini eşdeğer dize gösterimine dönüştürür.
ToString(String)	Belirtilen biçimi kullanarak geçerli BigInteger nesnenin sayısal değerini eşdeğer dize gösterimine dönüştürür.
ToString(IFormatProvider)	Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak geçerli BigInteger nesnenin sayısal değerini eşdeğer dize gösterimine dönüştürür.
ToString()	Geçerli BigInteger nesnenin sayısal değerini eşdeğer dize gösterimine dönüştürür.

ToString(String, IFormatProvider)

Kaynak:

BigInteger.cs

Belirtilen biçimi ve kültüre özgü biçim bilgilerini kullanarak geçerli BigInteger nesnenin sayısal değerini eşdeğer dize gösterimine dönüştürür.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);

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

override this.ToString : string * IFormatProvider -> string

Public Function ToString (format As String, provider As IFormatProvider) As String

Parametreler

format

String

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

provider

IFormatProvider

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

Döndürülenler

String

ve provider parametreleri tarafından belirtilen geçerli BigInteger değerin format dize gösterimi.

Uygulamalar

ToString(String, IFormatProvider)

Özel durumlar

FormatException

format geçerli bir biçim dizesi değil.

Örnekler

Aşağıdaki örnek bir BigInteger değeri başlatır ve standart bir biçim dizesi ve tilde (~) öğesini negatif bir işaret olarak tanımlayan bir NumberFormatInfo nesne kullanarak konsolda görüntüler.

// Redefine the negative sign as the tilde for the invariant culture.
NumberFormatInfo bigIntegerFormatter = new NumberFormatInfo();
bigIntegerFormatter.NegativeSign = "~";

BigInteger value = BigInteger.Parse("-903145792771643190182");
string[] specifiers = { "C", "D", "D25", "E", "E4", "e8", "F0",
                        "G", "N0", "P", "R", "X", "0,0.000",
                        "#,#.00#;(#,#.00#)" };

foreach (string specifier in specifiers)
   Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier,
                     bigIntegerFormatter));

// The example displays the following output:
//    C: (☼903,145,792,771,643,190,182.00)
//    D: ~903145792771643190182
//    D25: ~0000903145792771643190182
//    E: ~9.031457E+020
//    E4: ~9.0314E+020
//    e8: ~9.03145792e+020
//    F0: ~903145792771643190182
//    G: ~903145792771643190182
//    N0: ~903,145,792,771,643,190,182
//    P: ~90,314,579,277,164,319,018,200.00 %
//    R: ~903145792771643190182
//    X: CF0A55968BB1A7545A
//    0,0.000: ~903,145,792,771,643,190,182.000
//    #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)

    // Redefine the negative sign as the tilde for the invariant culture.
    let bigIntegerFormatter = NumberFormatInfo()
    bigIntegerFormatter.NegativeSign <- "~"

    let value = BigInteger.Parse "-903145792771643190182"

    let specifiers =
        [| "C"
           "D"
           "D25"
           "E"
           "E4"
           "e8"
           "F0"
           "G"
           "N0"
           "P"
           "R"
           "X"
           "0,0.000"
           "#,#.00#;(#,#.00#)" |]

    for specifier in specifiers do
        printfn $"{specifier}: {value.ToString(specifier, bigIntegerFormatter)}"

// The example displays the following output:
//    C: (☼903,145,792,771,643,190,182.00)
//    D: ~903145792771643190182
//    D25: ~0000903145792771643190182
//    E: ~9.031457E+020
//    E4: ~9.0314E+020
//    e8: ~9.03145792e+020
//    F0: ~903145792771643190182
//    G: ~903145792771643190182
//    N0: ~903,145,792,771,643,190,182
//    P: ~90,314,579,277,164,319,018,200.00 %
//    R: ~903145792771643190182
//    X: CF0A55968BB1A7545A
//    0,0.000: ~903,145,792,771,643,190,182.000
//    #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)

' Redefine the negative sign as the tilde for the invariant culture.
Dim bigIntegerFormatter As New NumberFormatInfo()
bigIntegerFormatter.NegativeSign = "~"

Dim value As BigInteger = BigInteger.Parse("-903145792771643190182")
Dim specifiers() As String = { "C", "D", "D25", "E", "E4", "e8", "F0", 
                               "G", "N0", "P", "R", "X", "0,0.000", 
                               "#,#.00#;(#,#.00#)" }

For Each specifier As String In specifiers
   Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier, 
                     bigIntegerformatter))
Next   
' The example displays the following output:
'    C: (☼903,145,792,771,643,190,182.00)
'    D: ~903145792771643190182
'    D25: ~0000903145792771643190182
'    E: ~9.031457E+020
'    E4: ~9.0314E+020
'    e8: ~9.03145792e+020
'    F0: ~903145792771643190182
'    G: ~903145792771643190182
'    N0: ~903,145,792,771,643,190,182
'    P: ~90,314,579,277,164,319,018,200.00 %
'    R: ~903145792771643190182
'    X: CF0A55968BB1A7545A
'    0,0.000: ~903,145,792,771,643,190,182.000
'    #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)

Açıklamalar

yöntemi, ToString(String, IFormatProvider) belirtilen bir BigInteger kültürün NumberFormatInfo nesnesini kullanarak bir değeri belirtilen biçimde biçimlendirebilir. Gidiş dönüş biçimini veya varsayılan 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
Gidiş dönüş ("R") biçimi	Varsayılan (geçerli) kültür	ToString()
Gidiş dönüş ("R") biçimi	Belirli bir kültür	ToString(IFormatProvider)
Belirli bir biçim	Varsayılan (geçerli) kültür	ToString(String)

format parametresi geçerli bir standart sayısal dize veya özel sayısal biçim dizelerinin herhangi bir bileşimi olabilir. veya nulldeğerine eşitse String.Emptyformat, geçerli BigInteger nesnenin dönüş değeri gidiş dönüş biçim tanımlayıcısı ("R") ile biçimlendirilir. Başka bir değerse format yöntemi bir FormatExceptionoluşturur.

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

• Sayısal biçim tanımlayıcıları hakkında daha fazla bilgi için bkz. Standart Sayısal Biçim Dizeleri ve Özel Sayısal Biçim Dizeleri.

• .NET'te biçimlendirme desteği hakkında daha fazla bilgi için bkz . Biçimlendirme Türleri.

provider parametresi bir IFormatProvider uygulamadır. GetFormat yöntemi, bu yöntem tarafından döndürülen dizenin biçimi hakkında kültüre özgü bilgiler sağlayan bir NumberFormatInfo nesnesi döndürür. ToString(String, IFormatProvider) yöntemi çağrıldığında parametresinin providerGetFormat yöntemini çağırır ve türü temsil NumberFormatInfo eden bir Type nesne iletir. Yöntemi GetFormat daha sonra negatif işaret simgesi, grup ayırıcı simgesi veya ondalık nokta simgesi gibi parametreyi biçimlendirmeye value yönelik bilgiler sağlayan nesneyi döndürürNumberFormatInfo. yöntemine biçimlendirme bilgileri ToString(String, IFormatProvider) sağlamak için parametresini kullanmanın provider üç yolu vardır:

• Biçimlendirme bilgileri sağlayan kültürü temsil eden bir CultureInfo nesne geçirebilirsiniz. GetFormat yöntemi, NumberFormatInfo bu kültür için sayısal biçimlendirme bilgileri sağlayan nesneyi döndürür.

• Sayısal biçimlendirme bilgileri sağlayan gerçek NumberFormatInfo nesneyi geçirebilirsiniz. (Uygulaması GetFormat yalnızca kendisini döndürür.)

• uygulayan IFormatProviderözel bir nesne geçirebilirsiniz. Yöntemi GetFormat , biçimlendirme bilgilerini sağlayan nesneyi oluşturur ve döndürür NumberFormatInfo .

ise providernull, döndürülen dizenin biçimlendirmesi geçerli kültürün NumberFormatInfo nesnesini temel alır.

Ayrıca bkz.

• Standart Sayısal Biçim Dizeleri
• Özel Sayısal Biçim Dizeleri

ToString(String)

Kaynak:

BigInteger.cs

Belirtilen biçimi kullanarak geçerli BigInteger nesnenin sayısal değerini eşdeğer dize gösterimine dönüştürür.

public:
 System::String ^ ToString(System::String ^ format);

public string ToString (string? format);

override this.ToString : string -> string

Public Function ToString (format As String) As String

Parametreler

format

String

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

Döndürülenler

String

Geçerli BigInteger değerin parametresi tarafından belirtilen biçimdeki format dize gösterimi.

Özel durumlar

FormatException

format geçerli bir biçim dizesi değil.

Örnekler

Aşağıdaki örnek bir BigInteger değeri başlatır ve her standart biçim dizesini ve bazı özel biçim dizelerini kullanarak görüntüler.

BigInteger value = BigInteger.Parse("-903145792771643190182");
string[] specifiers = { "C", "D", "D25", "E", "E4", "e8", "F0",
                        "G", "N0", "P", "R", "X", "0,0.000",
                        "#,#.00#;(#,#.00#)" };

foreach (string specifier in specifiers)
   Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));

// The example displays the following output:
//       C: ($903,145,792,771,643,190,182.00)
//       D: -903145792771643190182
//       D25: -0000903145792771643190182
//       E: -9.031457E+020
//       E4: -9.0314E+020
//       e8: -9.03145792e+020
//       F0: -903145792771643190182
//       G: -903145792771643190182
//       N0: -903,145,792,771,643,190,182
//       P: -90,314,579,277,164,319,018,200.00 %
//       R: -903145792771643190182
//       X: CF0A55968BB1A7545A
//       0,0.000: -903,145,792,771,643,190,182.000
//       #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)

    // Define a BigInteger value.
    let value = BigInteger.Parse "-903145792771643190182"

    let specifiers =
        [| "C"
           "D"
           "D25"
           "E"
           "E4"
           "e8"
           "F0"
           "G"
           "N0"
           "P"
           "R"
           "X"
           "0,0.000"
           "#,#.00#;(#,#.00#)" |]

    for specifier in specifiers do
        printfn $"{specifier}: {value.ToString specifier}"
// The example displays the following output:
//       C: ($903,145,792,771,643,190,182.00)
//       D: -903145792771643190182
//       D25: -0000903145792771643190182
//       E: -9.031457E+020
//       E4: -9.0314E+020
//       e8: -9.03145792e+020
//       F0: -903145792771643190182
//       G: -903145792771643190182
//       N0: -903,145,792,771,643,190,182
//       P: -90,314,579,277,164,319,018,200.00 %
//       R: -903145792771643190182
//       X: CF0A55968BB1A7545A
//       0,0.000: -903,145,792,771,643,190,182.000
//       #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)

Dim value As BigInteger = BigInteger.Parse("-903145792771643190182")
Dim specifiers() As String = { "C", "D", "D25", "E", "E4", "e8", "F0", 
                               "G", "N0", "P", "R", "X", "0,0.000", 
                               "#,#.00#;(#,#.00#)" }

For Each specifier As String In specifiers
   Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
Next   
' The example displays the following output:
'       C: ($903,145,792,771,643,190,182.00)
'       D: -903145792771643190182
'       D25: -0000903145792771643190182
'       E: -9.031457E+020
'       E4: -9.0314E+020
'       e8: -9.03145792e+020
'       F0: -903145792771643190182
'       G: -903145792771643190182
'       N0: -903,145,792,771,643,190,182
'       P: -90,314,579,277,164,319,018,200.00 %
'       R: -903145792771643190182
'       X: CF0A55968BB1A7545A
'       0,0.000: -903,145,792,771,643,190,182.000
'       #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)

Açıklamalar

yöntemi, ToString(String) geçerli kültürün kurallarını temsil eden bir NumberFormatInfo nesne kullanarak bir değeri belirtilen biçimde biçimlendirmektedirBigInteger. "R" kullanmak veya gidiş dönüş, biçimlendirmek veya farklı bir 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
Gidiş dönüş ("R") biçimi	Varsayılan (geçerli) kültür	ToString()
Gidiş dönüş ("R") biçimi	Belirli bir kültür	ToString(IFormatProvider)
Belirli bir biçim	Belirli bir kültür	ToString(String, IFormatProvider)

format parametresi geçerli bir standart sayısal dize veya özel sayısal biçim dizelerinin herhangi bir bileşimi olabilir. veya nulldeğerine eşitse String.Emptyformat, geçerli BigInteger nesnenin dönüş değeri gidiş dönüş biçim tanımlayıcısı ("R") ile biçimlendirilir. Başka bir değerse format yöntemi bir FormatExceptionoluşturur.

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

• Sayısal biçim tanımlayıcıları hakkında daha fazla bilgi için bkz. Standart Sayısal Biçim Dizeleri ve Özel Sayısal Biçim Dizeleri.

• .NET'te biçimlendirme desteği hakkında daha fazla bilgi için bkz . Biçimlendirme Türleri.

Döndürülen dizenin biçimi, geçerli kültürün NumberFormatInfo nesnesi tarafından belirlenir. Parametreye format bağlı olarak, bu nesne negatif işareti, grup ayırıcısı ve çıkış dizesindeki ondalık nokta simgesi gibi simgeleri denetler. Geçerli kültür dışındaki kültürler için biçimlendirme bilgileri sağlamak için aşırı yüklemeyi çağırın ToString(String, IFormatProvider) .

Ayrıca bkz.

• Standart Sayısal Biçim Dizeleri
• Özel Sayısal Biçim Dizeleri

ToString(IFormatProvider)

Kaynak:

BigInteger.cs

Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak geçerli BigInteger nesnenin sayısal değerini eşdeğer dize gösterimine dönüştürür.

public:
 System::String ^ ToString(IFormatProvider ^ provider);

public string ToString (IFormatProvider? provider);

override this.ToString : IFormatProvider -> string

Public Function ToString (provider As IFormatProvider) As String

Parametreler

provider

IFormatProvider

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

Döndürülenler

String

Geçerli BigInteger değerin parametresi tarafından belirtilen biçimdeki provider dize gösterimi.

Örnekler

Aşağıdaki örnek, tilde (~) negatif işareti olarak tanımlayan özel NumberFormatInfo bir nesnenin örneğini oluşturur. Yöntemi ToString(IFormatProvider) daha sonra negatif BigInteger bir değer görüntülemek için özel NumberFormatInfo nesnesini kullanır.

BigInteger number = 9867857831128;
number = BigInteger.Pow(number, 3) * BigInteger.MinusOne;

NumberFormatInfo bigIntegerProvider = new NumberFormatInfo();
bigIntegerProvider.NegativeSign = "~";

Console.WriteLine(number.ToString(bigIntegerProvider));

let number = bigint 9867857831128L
let number = BigInteger.Pow(number, 3) * BigInteger.MinusOne

let bigIntegerProvider = NumberFormatInfo()
bigIntegerProvider.NegativeSign <- "~"

printfn $"{number.ToString(bigIntegerProvider)}"

Dim number As BigInteger = 9867857831128
number = BigInteger.Pow(number, 3) * BigInteger.MinusOne

Dim bigIntegerProvider As New NumberFormatInfo()
bigIntegerProvider.NegativeSign = "~"      

Console.WriteLine(number.ToString(bigIntegerProvider))

Açıklamalar

yöntemi, ToString(IFormatProvider) belirtilen kültürün BigInteger nesnesini kullanarak NumberFormatInfo bir değeri "R" veya gidiş dönüş biçiminde biçimlendirir. Farklı bir biçim veya geçerli 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
Gidiş dönüş ("R") 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)

provider parametresi bir IFormatProvider uygulamadır. GetFormat yöntemi, bu yöntem tarafından döndürülen dizenin biçimi hakkında kültüre özgü bilgiler sağlayan bir NumberFormatInfo nesnesi döndürür. ise providernullBigInteger, değer geçerli kültürün NumberFormatInfo nesnesi kullanılarak biçimlendirilir. Genel biçim tanımlayıcısını kullanarak değerin dize gösterimini BigInteger denetleyen nesnesinin tek özelliğiNumberFormatInfo, negatif işareti temsil eden karakteri tanımlayan özelliğidirNumberFormatInfo.NegativeSign.

provider parametresi aşağıdakilerden biri olabilir:

• CultureInfo Biçimlendirme bilgileri sağlayan kültürü temsil eden bir nesne.

• NumberFormatInfo Biçimlendirme bilgileri sağlayan nesne.

• uygulayan IFormatProviderözel bir nesne. yöntemi GetFormat , biçimlendirme bilgilerini sağlayan nesneyi döndürür NumberFormatInfo .

ToString()

Kaynak:

BigInteger.cs

Geçerli BigInteger nesnenin sayısal değerini eşdeğer dize gösterimine dönüştürür.

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Döndürülenler

String

Geçerli BigInteger değerin dize gösterimi.

Örnekler

Aşağıdaki örnek, varsayılan ToString() yöntemi kullanarak bir BigInteger değer görüntüler. Ayrıca, bazı standart biçim tanımlayıcılarının kullanılmasından kaynaklanan değerin dize gösterimlerini BigInteger görüntüler. Örnekler, İngilizce (ABD) kültürünün biçimlendirme kurallarını kullanarak görüntülenir.

// Initialize a BigInteger value.
BigInteger value = BigInteger.Add(UInt64.MaxValue, 1024);

// Display value using the default ToString method.
Console.WriteLine(value.ToString());
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"));
Console.WriteLine(value.ToString("C"));
Console.WriteLine(value.ToString("D"));
Console.WriteLine(value.ToString("F"));
Console.WriteLine(value.ToString("N"));
Console.WriteLine(value.ToString("X"));
// The example displays the following output on a system whose current
// culture is en-US:
//       18446744073709552639
//       18446744073709552639
//       $18,446,744,073,709,552,639.00
//       18446744073709552639
//       18446744073709552639.00
//       18,446,744,073,709,552,639.00
//       100000000000003FF

    // Initialize a BigInteger value.
    let value = BigInteger.Add(UInt64.MaxValue, 1024)

    // Display value using the default ToString method.
    printfn $"{value.ToString()}"
    // Display value using some standard format specifiers.
    printfn $"""{value.ToString("G")}"""
    printfn $"""{value.ToString("C")}"""
    printfn $"""{value.ToString("D")}"""
    printfn $"""{value.ToString("F")}"""
    printfn $"""{value.ToString("N")}"""
    printfn $"""{value.ToString("X")}"""
// The example displays the following output on a system whose current
// culture is en-US:
//       18446744073709552639
//       18446744073709552639
//       $18,446,744,073,709,552,639.00
//       18446744073709552639
//       18446744073709552639.00
//       18,446,744,073,709,552,639.00
//       100000000000003FF

' Initialize a BigInteger value.
Dim value As BigInteger = BigInteger.Add(UInt64.MaxValue, 1024)

' Display value using the default ToString method.
Console.WriteLine(value.ToString())        
' Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"))
Console.WriteLine(value.ToString("C"))
Console.WriteLine(value.ToString("D"))
Console.WriteLine(value.ToString("F"))
Console.WriteLine(value.ToString("N"))
Console.WriteLine(value.ToString("X"))       
' The example displays the following output on a system whose current 
' culture is en-US:
'       18446744073709552639
'       18446744073709552639
'       $18,446,744,073,709,552,639.00
'       18446744073709552639
'       18446744073709552639.00
'       18,446,744,073,709,552,639.00
'       100000000000003FF

Açıklamalar

yöntemi bir ToString() değeri geçerli kültürün "R" veya gidiş dönüş biçiminde biçimlendirir BigInteger . 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
Gidiş dönüş ("R") biçimi	Belirli bir 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)

Değerin BigInteger dize gösterimi, değeri negatifse negatif bir işaret ve önünde sıfır olmadan 0 ile 9 arasında bir basamak dizisi içerir. Negatif işareti, geçerli kültür için nesnesi tarafından NumberFormatInfo tanımlanır.

Ayrıca bkz.

• Standart Sayısal Biçim Dizeleri
• Özel Sayısal Biçim Dizeleri