Aracılığıyla paylaş


BigInteger.ToString Yöntem

Tanım

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
Kaynak:
BigInteger.cs
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);
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

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

Uygulamalar

Özel durumlar

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:

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.

Şunlara uygulanır

ToString(String)

Kaynak:
BigInteger.cs
Kaynak:
BigInteger.cs
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);
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

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

Özel durumlar

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:

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.

Şunlara uygulanır

ToString(IFormatProvider)

Kaynak:
BigInteger.cs
Kaynak:
BigInteger.cs
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);
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

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:

Şunlara uygulanır

ToString()

Kaynak:
BigInteger.cs
Kaynak:
BigInteger.cs
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

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.

Şunlara uygulanır