BigInteger.ToString Metode

Referensi

Definisi

Ruang nama:: System.Numerics

Rakitan:: System.Runtime.Numerics.dll

Rakitan:: System.Numerics.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengonversi nilai numerik objek BigInteger saat ini ke representasi string yang setara.

Overload

ToString(String, IFormatProvider)	Mengonversi nilai numerik objek BigInteger saat ini ke representasi string yang setara dengan menggunakan format yang ditentukan dan informasi format khusus budaya.
ToString(String)	Mengonversi nilai numerik objek BigInteger saat ini ke representasi string yang setara dengan menggunakan format yang ditentukan.
ToString(IFormatProvider)	Mengonversi nilai numerik objek BigInteger saat ini ke representasi string yang setara dengan menggunakan informasi pemformatan khusus budaya yang ditentukan.
ToString()	Mengonversi nilai numerik objek BigInteger saat ini ke representasi string yang setara.

ToString(String, IFormatProvider)

Sumber:: BigInteger.cs

Sumber:: BigInteger.cs

Sumber:: BigInteger.cs

Mengonversi nilai numerik objek BigInteger saat ini ke representasi string yang setara dengan menggunakan format yang ditentukan dan informasi format khusus budaya.

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

Parameter

format: String

String format numerik standar atau kustom.

provider: IFormatProvider

Objek yang memasok informasi pemformatan khusus budaya.

Mengembalikan

String

Representasi string dari nilai BigInteger saat ini seperti yang ditentukan oleh parameter format dan provider.

Penerapan

ToString(String, IFormatProvider)

Pengecualian

FormatException

format bukan string format yang valid.

Contoh

Contoh berikut menginisialisasi nilai BigInteger, dan menampilkannya ke konsol menggunakan string format standar dan objek NumberFormatInfo yang menentukan tilde (~) sebagai tanda negatif.

// 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)

Keterangan

Metode ToString(String, IFormatProvider) memformat nilai BigInteger dalam format tertentu dengan menggunakan objek NumberFormatInfo dari budaya tertentu. Jika Anda ingin menggunakan format pulang pergi atau pengaturan budaya default, gunakan kelebihan beban lain dari metode ToString, sebagai berikut:

Untuk menggunakan format	Untuk budaya	Menggunakan kelebihan beban
Format round-trip ("R")	Budaya default (saat ini)	ToString()
Format round-trip ("R")	Budaya tertentu	ToString(IFormatProvider)
Format tertentu	Budaya default (saat ini)	ToString(String)

Parameter format dapat berupa string numerik standar yang valid, atau kombinasi string format numerik kustom . Jika format sama dengan String.Empty atau null, nilai pengembalian objek BigInteger saat ini diformat dengan penentu format pulang-pergi ("R"). Jika format adalah nilai lain, metode melemparkan FormatException.

.NET menyediakan dukungan pemformatan ekstensif, yang dijelaskan secara lebih rinci dalam topik pemformatan berikut:

Untuk informasi selengkapnya tentang penentu format numerik, lihat String Format Numerik Standar dan String Format Numerik Kustom.
Untuk informasi selengkapnya tentang dukungan untuk pemformatan di .NET, lihat Tipe Pemformatan.

Parameter provider adalah implementasi IFormatProvider. Metode GetFormat mengembalikan objek NumberFormatInfo yang menyediakan informasi khusus budaya tentang format string yang dikembalikan oleh metode ini. Ketika metode ToString(String, IFormatProvider) dipanggil, metode ini memanggil metode GetFormat parameter provider dan meneruskannya objek Type yang mewakili jenis NumberFormatInfo. Metode GetFormat kemudian mengembalikan objek NumberFormatInfo yang menyediakan informasi untuk memformat parameter value, seperti simbol tanda negatif, simbol pemisah grup, atau simbol titik desimal. Ada tiga cara untuk menggunakan parameter provider untuk menyediakan informasi pemformatan ke metode ToString(String, IFormatProvider):

Anda dapat meneruskan objek CultureInfo yang mewakili budaya yang menyediakan informasi pemformatan. Metode GetFormat mengembalikan objek NumberFormatInfo yang menyediakan informasi pemformatan numerik untuk budaya tersebut.
Anda dapat meneruskan objek NumberFormatInfo aktual yang menyediakan informasi pemformatan numerik. (Implementasinya GetFormat hanya mengembalikan dirinya sendiri.)
Anda dapat meneruskan objek kustom yang mengimplementasikan IFormatProvider. Metode GetFormat membuat instans dan mengembalikan objek NumberFormatInfo yang menyediakan informasi pemformatan.

Jika providernull, pemformatan string yang dikembalikan didasarkan pada objek NumberFormatInfo budaya saat ini.

Lihat juga

Berlaku untuk

ToString(String)

Sumber:: BigInteger.cs

Sumber:: BigInteger.cs

Sumber:: BigInteger.cs

Mengonversi nilai numerik objek BigInteger saat ini ke representasi string yang setara dengan menggunakan format yang ditentukan.

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

Parameter

format: String

String format numerik standar atau kustom.

Mengembalikan

String

Representasi string dari nilai BigInteger saat ini dalam format yang ditentukan oleh parameter format.

Pengecualian

FormatException

format bukan string format yang valid.

Contoh

Contoh berikut menginisialisasi nilai BigInteger dan menampilkannya dengan menggunakan setiap string format standar dan beberapa string format kustom.

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)

Keterangan

Metode ToString(String) memformat nilai BigInteger dalam format tertentu dengan menggunakan objek NumberFormatInfo yang mewakili konvensi budaya saat ini. Jika Anda ingin menggunakan "R", atau pulang pergi, format atau tentukan budaya yang berbeda, gunakan kelebihan beban lain dari metode ToString, sebagai berikut:

Untuk menggunakan format	Untuk budaya	Menggunakan kelebihan beban
Format round-trip ("R")	Budaya default (saat ini)	ToString()
Format round-trip ("R")	Budaya tertentu	ToString(IFormatProvider)
Format tertentu	Budaya tertentu	ToString(String, IFormatProvider)

.NET menyediakan dukungan pemformatan ekstensif, yang dijelaskan secara lebih rinci dalam topik pemformatan berikut:

Untuk informasi selengkapnya tentang penentu format numerik, lihat String Format Numerik Standar dan String Format Numerik Kustom.
Untuk informasi selengkapnya tentang dukungan untuk pemformatan di .NET, lihat Tipe Pemformatan.

Format string yang dikembalikan ditentukan oleh objek NumberFormatInfo untuk budaya saat ini. Bergantung pada parameter format, objek ini mengontrol simbol seperti tanda negatif, pemisah grup, dan simbol titik desimal dalam string output. Untuk memberikan informasi pemformatan untuk budaya selain budaya saat ini, panggil ToString(String, IFormatProvider) kelebihan beban.

Lihat juga

Berlaku untuk

ToString(IFormatProvider)

Sumber:: BigInteger.cs

Sumber:: BigInteger.cs

Sumber:: BigInteger.cs

Mengonversi nilai numerik objek BigInteger saat ini ke representasi string yang setara dengan menggunakan informasi pemformatan khusus budaya yang ditentukan.

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

Parameter

provider: IFormatProvider

Objek yang memasok informasi pemformatan khusus budaya.

Mengembalikan

String

Representasi string dari nilai BigInteger saat ini dalam format yang ditentukan oleh parameter provider.

Contoh

Contoh berikut membuat instans objek NumberFormatInfo kustom yang menentukan tilde (~) sebagai tanda negatif. Metode ToString(IFormatProvider) kemudian menggunakan objek NumberFormatInfo kustom untuk menampilkan nilai BigInteger negatif.

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))

Keterangan

Metode ToString(IFormatProvider) memformat nilai BigInteger dalam format "R", atau pulang pergi, dengan menggunakan objek NumberFormatInfo dari budaya tertentu. Jika Anda ingin menentukan format yang berbeda atau budaya saat ini, gunakan kelebihan beban lain dari metode ToString, sebagai berikut:

Untuk menggunakan format	Untuk budaya	Menggunakan kelebihan beban
Format round-trip ("R")	Budaya default (saat ini)	ToString()
Format tertentu	Budaya default (saat ini)	ToString(String)
Format tertentu	Budaya tertentu	ToString(String, IFormatProvider)

Parameter provider adalah implementasi IFormatProvider. Metode GetFormat mengembalikan objek NumberFormatInfo yang menyediakan informasi khusus budaya tentang format string yang dikembalikan oleh metode ini. Jika providernull, nilai BigInteger diformat menggunakan objek NumberFormatInfo budaya saat ini. Satu-satunya properti objek NumberFormatInfo yang mengontrol representasi string dari nilai BigInteger menggunakan penentu format umum adalah NumberFormatInfo.NegativeSign, yang menentukan karakter yang mewakili tanda negatif.

Parameter provider dapat berupa salah satu hal berikut:

Objek CultureInfo yang mewakili budaya yang menyediakan informasi pemformatan.
Objek NumberFormatInfo yang menyediakan informasi pemformatan.
Objek kustom yang mengimplementasikan IFormatProvider. Metode GetFormat mengembalikan objek NumberFormatInfo yang menyediakan informasi pemformatan.

Berlaku untuk

ToString()

Sumber:: BigInteger.cs

Sumber:: BigInteger.cs

Sumber:: BigInteger.cs

Mengonversi nilai numerik objek BigInteger saat ini ke representasi string yang setara.

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

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Mengembalikan

String

Representasi string dari nilai BigInteger saat ini.

Contoh

Contoh berikut menampilkan nilai BigInteger dengan menggunakan metode ToString() default. Ini juga menampilkan representasi string dari nilai BigInteger yang dihasilkan dari menggunakan beberapa penentu format standar. Contoh ditampilkan menggunakan konvensi pemformatan budaya en-US.

// 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

Keterangan

Metode ToString() memformat nilai BigInteger dalam format "R", atau pulang-pergi, format budaya saat ini. Jika Anda ingin menentukan format atau budaya yang berbeda, gunakan kelebihan beban lain dari metode ToString, sebagai berikut:

Untuk menggunakan format	Untuk budaya	Menggunakan kelebihan beban
Format round-trip ("R")	Budaya tertentu	ToString
Format tertentu	Budaya default (saat ini)	ToString(String)
Format tertentu	Budaya tertentu	ToString(String, IFormatProvider)

Representasi string dari nilai BigInteger menyertakan tanda negatif jika nilainya negatif, dan urutan digit mulai dari 0 hingga 9 tanpa nol di depannya. Tanda negatif didefinisikan oleh objek NumberFormatInfo untuk budaya saat ini.

Lihat juga

Berlaku untuk

Bagikan melalui

BigInteger.ToString Metode

Definisi

Overload

ToString(String, IFormatProvider)

Parameter

Mengembalikan

Penerapan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

ToString(String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

ToString(IFormatProvider)

Parameter

Mengembalikan

Contoh

Keterangan

Berlaku untuk

ToString()

Mengembalikan

Contoh

Keterangan

Lihat juga

Berlaku untuk

Sumber Daya Tambahan: