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 saat ini BigInteger ke representasi string yang setara.

Overload

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

ToString(String, IFormatProvider)

Sumber:: BigInteger.cs

Sumber:: BigInteger.cs

Sumber:: BigInteger.cs

Mengonversi nilai numerik objek saat ini BigInteger 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 saat ini BigInteger seperti yang ditentukan oleh format parameter dan provider .

Penerapan

ToString(String, IFormatProvider)

Pengecualian

FormatException

format bukan string format yang valid.

Contoh

Contoh berikut menginisialisasi BigInteger nilai, dan menampilkannya ke konsol menggunakan string format standar dan NumberFormatInfo objek 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 memformat ToString(String, IFormatProvider)BigInteger nilai dalam format tertentu dengan menggunakan NumberFormatInfo objek budaya tertentu. Jika Anda ingin menggunakan format pulang-pergi atau pengaturan budaya default, gunakan kelebihan beban ToString metode lainnya, sebagai berikut:

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

Parameter format dapat berupa string numerik standar yang valid, atau kombinasi string format numerik kustom apa pun. Jika format sama dengan String.Empty atau adalah null, nilai pengembalian objek saat ini BigInteger diformat dengan penentu format pulang-pergi ("R"). Jika format adalah nilai lain, metode akan melempar 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 Jenis Pemformatan.

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

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

Jika provider adalah null, pemformatan string yang dikembalikan didasarkan pada NumberFormatInfo objek budaya saat ini.

Lihat juga

Berlaku untuk

ToString(String)

Sumber:: BigInteger.cs

Sumber:: BigInteger.cs

Sumber:: BigInteger.cs

Mengonversi nilai numerik objek saat ini BigInteger 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 saat ini BigInteger dalam format yang ditentukan oleh format parameter .

Pengecualian

FormatException

format bukan string format yang valid.

Contoh

Contoh berikut menginisialisasi BigInteger nilai 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 memformat ToString(String)BigInteger nilai dalam format tertentu dengan menggunakan NumberFormatInfo objek yang mewakili konvensi budaya saat ini. Jika Anda ingin menggunakan "R", atau round-trip, format atau menentukan budaya yang berbeda, gunakan kelebihan beban ToString metode lainnya, sebagai berikut:

Untuk menggunakan format	Untuk budaya	Menggunakan kelebihan beban
Format round-trip ("R")	Kultur 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 Jenis Pemformatan.

Format string yang dikembalikan ditentukan oleh NumberFormatInfo objek untuk budaya saat ini. Bergantung pada format parameter , 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 kelebihan ToString(String, IFormatProvider) beban.

Lihat juga

Berlaku untuk

ToString(IFormatProvider)

Sumber:: BigInteger.cs

Sumber:: BigInteger.cs

Sumber:: BigInteger.cs

Mengonversi nilai numerik objek saat ini BigInteger 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 saat ini BigInteger dalam format yang ditentukan oleh provider parameter .

Contoh

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

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 memformat ToString(IFormatProvider)BigInteger nilai dalam format "R", atau pulang-pergi, dengan menggunakan NumberFormatInfo objek budaya tertentu. Jika Anda ingin menentukan format yang berbeda atau budaya saat ini, gunakan kelebihan beban ToString metode lainnya, sebagai berikut:

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

Parameter provider adalah IFormatProvider implementasi. Metodenya GetFormat mengembalikan NumberFormatInfo objek yang menyediakan informasi khusus budaya tentang format string yang dikembalikan oleh metode ini. Jika provider adalah null, nilai diformat BigInteger menggunakan NumberFormatInfo objek budaya saat ini. Satu-satunya NumberFormatInfo properti objek yang mengontrol representasi BigInteger string dari nilai 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 memasok informasi pemformatan.
Objek NumberFormatInfo yang menyediakan informasi pemformatan.
Objek kustom yang mengimplementasikan IFormatProvider. Metodenya GetFormat mengembalikan NumberFormatInfo objek yang memasok informasi pemformatan.

Berlaku untuk

ToString()

Sumber:: BigInteger.cs

Sumber:: BigInteger.cs

Sumber:: BigInteger.cs

Mengonversi nilai numerik objek saat ini BigInteger 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 saat ini BigInteger .

Contoh

Contoh berikut menampilkan BigInteger nilai dengan menggunakan metode default ToString() . Ini juga menampilkan representasi string dari BigInteger nilai 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 ini ToString() memformat BigInteger nilai dalam format "R", atau round-trip, dari budaya saat ini. Jika Anda ingin menentukan format atau budaya yang berbeda, gunakan kelebihan beban ToString metode lainnya, sebagai berikut:

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

Representasi string nilai BigInteger menyertakan tanda negatif jika nilainya negatif, dan urutan digit berkisar antara 0 hingga 9 tanpa nol di depannya. Tanda negatif didefinisikan oleh NumberFormatInfo objek 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: