Bagikan melalui


Single.ToString Metode

Definisi

Mengonversi nilai numerik instans ini ke representasi string yang setara.

Overload

ToString()

Mengonversi nilai numerik instans ini ke representasi string yang setara.

ToString(IFormatProvider)

Mengonversi nilai numerik instans ini ke representasi string yang setara menggunakan informasi format khusus budaya yang ditentukan.

ToString(String)

Mengonversi nilai numerik instans ini ke representasi string yang setara, menggunakan format yang ditentukan.

ToString(String, IFormatProvider)

Mengonversi nilai numerik instans ini ke representasi string yang setara menggunakan format yang ditentukan dan informasi format khusus budaya.

ToString()

Sumber:
Single.cs
Sumber:
Single.cs
Sumber:
Single.cs

Mengonversi nilai numerik instans 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

Representasi string dari nilai instans ini.

Contoh

Contoh berikut menggunakan metode default Single.ToString untuk menampilkan representasi string dari sejumlah Single nilai.

float number;

number = 1.6E20F;
// Displays 1.6E+20.
Console.WriteLine(number.ToString());

number = 1.6E2F;
// Displays 160.
Console.WriteLine(number.ToString());

number = -3.541F;
// Displays -3.541.
Console.WriteLine(number.ToString());

number = -1502345222199E-07F;
// Displays -150234.5222199.
Console.WriteLine(number.ToString());

number = -15023452221990199574E-09F;
// Displays -15023452221.9902.
Console.WriteLine(number.ToString());

number = .60344F;
// Displays 0.60344.
Console.WriteLine(number.ToString());

number = .000000001F;
// Displays 1E-09.
Console.WriteLine(number.ToString());
let number = 1.6E20F
// Displays 1.6E+20.
printfn $"{number.ToString()}"

let number = 1.6E2F
// Displays 160.
printfn $"{number.ToString()}"

let number = -3.541F
// Displays -3.541.
printfn $"{number.ToString()}"

let number = -1502345222199E-07F
// Displays -150234.5222199.
printfn $"{number.ToString()}"

let number = -15023452221990199574E-09F
// Displays -15023452221.9902.
printfn $"{number.ToString()}"

let number = 0.60344F
// Displays 0.60344.
printfn $"{number.ToString()}"

let number = 0.000000001F
// Displays 1E-09.
printfn $"{number.ToString()}"
Dim number As Single

number = 1.6E20
' Displays 1.6E+20.      
Console.WriteLine(number.ToString())

number = 1.6E2
' Displays 160.
Console.WriteLine(number.ToString())

number = -3.541
' Displays -3.541.
Console.WriteLine(number.ToString())

number = -1502345222199E-07
' Displays -150234.5222199.
Console.WriteLine(number.ToString())

number = -15023452221990199574E-09
' Displays -15023452221.9902.
Console.WriteLine(number.ToString())

number = .60344
' Displays 0.60344.
Console.WriteLine(number.ToString())

number = .000000001
' Displays 1E-09.
Console.WriteLine(number.ToString())

Contoh kode berikut mengilustrasikan penggunaan Parse(String) metode bersama dengan ToString() metode .

bool done = false;
String^ inp;
do
{
   Console::Write( "Enter a real number: " );
   inp = Console::ReadLine();
   try
   {
      s = Single::Parse( inp );
      Console::WriteLine( "You entered {0}.", s );
      done = true;
   }
   catch ( FormatException^ ) 
   {
      Console::WriteLine( "You did not enter a number." );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "An exception occurred while parsing your response: {0}", e );
   }
}
while (  !done );
bool done = false;
string inp;
do
{
    Console.Write("Enter a real number: ");
    inp = Console.ReadLine();
    try
    {
        s = Single.Parse(inp);
        Console.WriteLine("You entered {0}.", s.ToString());
        done = true;
    }
    catch (FormatException)
    {
        Console.WriteLine("You did not enter a number.");
    }
    catch (Exception e)
    {
        Console.WriteLine("An exception occurred while parsing your response: {0}", e.ToString());
    }
} while (!done);
let mutable finished = false
while not finished do
    printf "Enter a real number: "
    let inp = stdin.ReadLine()
    try
        let s = Single.Parse inp
        printfn $"You entered {s}."
        finished <- true
    with 
    | :? FormatException ->
        printfn "You did not enter a number."
    | e ->
        printfn "An exception occurred while parsing your response: {e}"
Dim Done As Boolean = False
Dim Inp As String
Do

    Console.Write("Enter a real number: ")
    Inp = Console.ReadLine()
    Try
        S = Single.Parse(Inp)
        Console.WriteLine("You entered " + S.ToString() + ".")
        Done = True
    Catch E As FormatException
        Console.WriteLine("You did not enter a number.")
    Catch E As Exception
        Console.WriteLine("An exception occurred while parsing your response: " + E.ToString())
    End Try
Loop While Not Done

Keterangan

Metode memformat ToString()Single nilai dalam format default ("G", atau umum) 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 default ("G") Budaya tertentu ToString(IFormatProvider)
Format tertentu Kultur default (saat ini) ToString(String)
Format tertentu Budaya tertentu ToString(String, IFormatProvider)

Nilai yang dikembalikan dapat berupa PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol, atau string formulir:

[sign]integral-digits[.[ fractional-digits]][e[sign]exponential-digits]

Elemen opsional dibingkai dalam tanda kurung siku ([ dan ]). Elemen yang berisi istilah "digit" terdiri dari serangkaian karakter numerik mulai dari 0 hingga 9. Tabel berikut ini mencantumkan setiap elemen:

Elemen Deskripsi
sign Tanda negatif atau simbol tanda positif.
integral-digits Serangkaian digit yang menentukan bagian integral dari angka tersebut. Digit integral dapat tidak ada jika ada digit pecahan.
'.' Simbol titik desimal khusus budaya.
fractional-digits Serangkaian digit yang menentukan bagian pecahan dari angka.
'e' Karakter huruf kecil 'e', menunjukkan notasi eksponensial (ilmiah).
digit eksponensial Serangkaian digit yang menentukan eksponen.

Beberapa contoh nilai pengembalian adalah "100", "-123,456,789", "123.45e+6", "500", "3.1416", "600", "-0.123", dan "-Infinity".

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

Lihat juga

Berlaku untuk

ToString(IFormatProvider)

Sumber:
Single.cs
Sumber:
Single.cs
Sumber:
Single.cs

Mengonversi nilai numerik instans ini ke representasi string yang setara menggunakan informasi format khusus budaya yang ditentukan.

public:
 virtual System::String ^ ToString(IFormatProvider ^ provider);
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

Representasi string dari nilai instans ini seperti yang ditentukan oleh provider.

Penerapan

Contoh

Contoh berikut menampilkan representasi string dari dua Single nilai menggunakan CultureInfo objek yang mewakili beberapa budaya yang berbeda.

float value;

value = -16325.62015F;
// 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")));

value = 16034.125E21F;
// 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.62015
//       -16325.62015
//       -16325,62015
//       1.6034125E+25
//       1.6034125E+25
//       1,6034125E+25
let value = -16325.62015F
// Display value using the invariant culture.
printfn $"{value.ToString CultureInfo.InvariantCulture}"
// Display value using the en-GB culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "en-GB")}"""
// Display value using the de-DE culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "de-DE")}"""

let value = 16034.125E21F
// Display value using the invariant culture.
printfn $"{value.ToString CultureInfo.InvariantCulture}"
// Display value using the en-GB culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "en-GB")}"""
// Display value using the de-DE culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "de-DE")}"""
// This example displays the following output to the console:
//       -16325.62015
//       -16325.62015
//       -16325,62015
//       1.6034125E+25
//       1.6034125E+25
//       1,6034125E+25
Dim value As Single 

value = -16325.62015
' 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")))

value = 16034.125E21
' 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.62015
'       -16325.62015
'       -16325,62015
'       1.6034125E+25
'       1.6034125E+25
'       1,6034125E+25

Keterangan

Metode memformat ToString(IFormatProvider)Single nilai dalam format default ("G", atau umum) dari 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 default ("G") Kultur default (saat ini) ToString()
Format tertentu Kultur default (saat ini) ToString(String)
Format tertentu Budaya tertentu ToString(String, IFormatProvider)

Nilai yang dikembalikan dapat berupa PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol, atau string formulir:

[sign]integral-digits[.[ fractional-digits]][e[sign]exponential-digits]

Elemen opsional dibingkai dalam tanda kurung siku ([ dan ]). Elemen yang berisi istilah "digit" terdiri dari serangkaian karakter numerik mulai dari 0 hingga 9. Tabel berikut mencantumkan setiap elemen.

Elemen Deskripsi
sign Tanda negatif atau simbol tanda positif.
integral-digits Serangkaian digit yang menentukan bagian integral dari angka tersebut. Digit integral dapat tidak ada jika ada digit pecahan.
'.' Simbol titik desimal khusus budaya.
fractional-digits Serangkaian digit yang menentukan bagian pecahan dari angka.
'e' Karakter huruf kecil 'e', menunjukkan notasi eksponensial (ilmiah).
digit eksponensial Serangkaian digit yang menentukan eksponen.

Beberapa contoh nilai pengembalian adalah "100", "-123,456,789", "123.45e+6", "500", "3.1416", "600", "-0.123", dan "-Infinity".

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

Parameter provider adalah IFormatProvider implementasi yang metodenya GetFormat mengembalikan NumberFormatInfo objek . Biasanya, provider adalah CultureInfo objek atau NumberFormatInfo objek. Parameter provider memasok informasi khusus budaya yang digunakan dalam pemformatan. Jika provider adalah null, nilai yang dikembalikan diformat menggunakan NumberFormatInfo data untuk budaya saat ini.

Untuk mengonversi Single nilai ke representasi stringnya menggunakan budaya tertentu dan string format tertentu, panggil Single.ToString(String, IFormatProvider) metode .

Lihat juga

Berlaku untuk

ToString(String)

Sumber:
Single.cs
Sumber:
Single.cs
Sumber:
Single.cs

Mengonversi nilai numerik instans ini ke representasi string yang setara, 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.

Mengembalikan

Representasi string dari nilai instans ini seperti yang ditentukan oleh format.

Pengecualian

format tidak valid.

Contoh

Contoh berikut mendefinisikan nilai numerik dan memformatnya sebagai nilai mata uang dengan menggunakan string format numerik standar "C" dan sebagai nilai numerik ke tiga tempat desimal dengan menggunakan string format numerik standar "N". String hasil diformat dengan menggunakan konvensi budaya en-US. Untuk informasi selengkapnya tentang string format numerik, lihat String Format Numerik Standar dan String Format Numerik Kustom.

using System;

public class Example
{
   public static void Main()
   {
      Double number = 1764.3789;
      
      // Format as a currency value.
      Console.WriteLine(number.ToString("C"));
      
      // Format as a numeric value with 3 decimal places.
      Console.WriteLine(number.ToString("N3"));
   }
}
// The example displays the following output:
//       $1,764.38
//       1,764.379
let number = 1764.3789

// Format as a currency value.
printfn $"""{number.ToString "C"}"""

// Format as a numeric value with 3 decimal places.
printfn $"""{number.ToString "N3"}"""
// The example displays the following output:
//       $1,764.38
//       1,764.379
Module Example
   Public Sub Main()
      Dim number As Single = 1764.3789
      
      ' Format as a currency value.
      Console.WriteLine(number.ToString("C"))
      
      ' Format as a numeric value with 3 decimal places.
      Console.WriteLine(number.ToString("N3"))
   End Sub
End Module
' The example displays the following output:
'       $1,764.38
'       1,764.379

Contoh berikut menampilkan beberapa Single nilai menggunakan masing-masing penentu format numerik standar yang didukung bersama dengan dua string format numerik kustom. Salah satu string format kustom tersebut menggambarkan cara Single mengayuh nilai dengan nol di depannya. Dalam mengonversi nilai numerik menjadi string, contohnya menggunakan konvensi pemformatan budaya en-US.

float[] numbers= { 1054.32179F, -195489100.8377F, 1.0437E21F, 
                   -1.0573e-05F };
string[] specifiers = { "C", "E", "e", "F", "G", "N", "P", 
                        "R", "#,000.000", "0.###E-000",
                        "000,000,000,000.00###" };

foreach (float number in numbers)
{
   Console.WriteLine("Formatting of {0}:", number);
   foreach (string specifier in specifiers)
      Console.WriteLine("   {0,5}: {1}", 
                        specifier, number.ToString(specifier));

   Console.WriteLine();
}
// The example displays the following output to the console:
//       Formatting of 1054.32179:
//              C: $1,054.32
//              E: 1.054322E+003
//              e: 1.054322e+003
//              F: 1054.32
//              G: 1054.32179
//              N: 1,054.32
//              P: 105,432.18 %
//              R: 1054.32179
//          #,000.000: 1,054.322
//          0.###E-000: 1.054E003
//          000,000,000,000.00###: 000,000,001,054.322
//       
//       Formatting of -195489100.8377:
//              C: ($195,489,100.84)
//              E: -1.954891E+008
//              e: -1.954891e+008
//              F: -195489100.84
//              G: -195489100.8377
//              N: -195,489,100.84
//              P: -19,548,910,083.77 %
//              R: -195489100.8377
//          #,000.000: -195,489,100.838
//          0.###E-000: -1.955E008
//          000,000,000,000.00###: -000,195,489,100.00
//       
//       Formatting of 1.0437E+21:
//              C: $1,043,700,000,000,000,000,000.00
//              E: 1.043700E+021
//              e: 1.043700e+021
//              F: 1043700000000000000000.00
//              G: 1.0437E+21
//              N: 1,043,700,000,000,000,000,000.00
//              P: 104,370,000,000,000,000,000,000.00 %
//              R: 1.0437E+21
//          #,000.000: 1,043,700,000,000,000,000,000.000
//          0.###E-000: 1.044E021
//          000,000,000,000.00###: 1,043,700,000,000,000,000,000.00
//       
//       Formatting of -1.0573E-05:
//              C: $0.00
//              E: -1.057300E-005
//              e: -1.057300e-005
//              F: 0.00
//              G: -1.0573E-05
//              N: 0.00
//              P: 0.00 %
//              R: -1.0573E-05
//          #,000.000: 000.000
//          0.###E-000: -1.057E-005
//          000,000,000,000.00###: -000,000,000,000.00001
let numbers = 
    [| 1054.32179F; -195489100.8377F; 1.0437E21F; -1.0573e-05F |]
let specifiers = 
    [| "C"; "E"; "e"; "F"; "G"; "N"; "P" 
       "R"; "#,000.000"; "0.###E-000"
       "000,000,000,000.00###" |]

for number in numbers do
    printfn $"Formatting of {number}:"
    for specifier in specifiers do
        printfn $"   {specifier,5}: {number.ToString specifier}" 
    printfn ""
// The example displays the following output to the console:
//       Formatting of 1054.32179:
//              C: $1,054.32
//              E: 1.054322E+003
//              e: 1.054322e+003
//              F: 1054.32
//              G: 1054.32179
//              N: 1,054.32
//              P: 105,432.18 %
//              R: 1054.32179
//          #,000.000: 1,054.322
//          0.###E-000: 1.054E003
//          000,000,000,000.00###: 000,000,001,054.322
//       
//       Formatting of -195489100.8377:
//              C: ($195,489,100.84)
//              E: -1.954891E+008
//              e: -1.954891e+008
//              F: -195489100.84
//              G: -195489100.8377
//              N: -195,489,100.84
//              P: -19,548,910,083.77 %
//              R: -195489100.8377
//          #,000.000: -195,489,100.838
//          0.###E-000: -1.955E008
//          000,000,000,000.00###: -000,195,489,100.00
//       
//       Formatting of 1.0437E+21:
//              C: $1,043,700,000,000,000,000,000.00
//              E: 1.043700E+021
//              e: 1.043700e+021
//              F: 1043700000000000000000.00
//              G: 1.0437E+21
//              N: 1,043,700,000,000,000,000,000.00
//              P: 104,370,000,000,000,000,000,000.00 %
//              R: 1.0437E+21
//          #,000.000: 1,043,700,000,000,000,000,000.000
//          0.###E-000: 1.044E021
//          000,000,000,000.00###: 1,043,700,000,000,000,000,000.00
//       
//       Formatting of -1.0573E-05:
//              C: $0.00
//              E: -1.057300E-005
//              e: -1.057300e-005
//              F: 0.00
//              G: -1.0573E-05
//              N: 0.00
//              P: 0.00 %
//              R: -1.0573E-05
//          #,000.000: 000.000
//          0.###E-000: -1.057E-005
//          000,000,000,000.00###: -000,000,000,000.00001
Dim numbers() As Single = {1054.32179, -195489100.8377, 1.0437E21, _
                           -1.0573e-05}
Dim specifiers() As String = { "C", "E", "e", "F", "G", "N", "P", _
                               "R", "#,000.000", "0.###E-000", _
                               "000,000,000,000.00###"}
For Each number As Single In numbers
   Console.WriteLine("Formatting of {0}:", number)
   For Each specifier As String In specifiers
      Console.WriteLine("   {0,5}: {1}", _
                        specifier, number.ToString(specifier))
   Next
   Console.WriteLine()
Next
' The example displays the following output to the console:
'       Formatting of 1054.32179:
'              C: $1,054.32
'              E: 1.054322E+003
'              e: 1.054322e+003
'              F: 1054.32
'              G: 1054.32179
'              N: 1,054.32
'              P: 105,432.18 %
'              R: 1054.32179
'          #,000.000: 1,054.322
'          0.###E-000: 1.054E003
'          000,000,000,000.00###: 000,000,001,054.322      
'       
'       Formatting of -195489100.8377:
'              C: ($195,489,100.84)
'              E: -1.954891E+008
'              e: -1.954891e+008
'              F: -195489100.84
'              G: -195489100.8377
'              N: -195,489,100.84
'              P: -19,548,910,083.77 %
'              R: -195489100.8377
'          #,000.000: -195,489,100.838
'          0.###E-000: -1.955E008
'          000,000,000,000.00###: -000,195,489,100.00
'       
'       Formatting of 1.0437E+21:
'              C: $1,043,700,000,000,000,000,000.00
'              E: 1.043700E+021
'              e: 1.043700e+021
'              F: 1043700000000000000000.00
'              G: 1.0437E+21
'              N: 1,043,700,000,000,000,000,000.00
'              P: 104,370,000,000,000,000,000,000.00 %
'              R: 1.0437E+21
'          #,000.000: 1,043,700,000,000,000,000,000.000
'          0.###E-000: 1.044E021
'          000,000,000,000.00###: 1,043,700,000,000,000,000,000.00
'       
'       Formatting of -1.0573E-05:
'              C: $0.00
'              E: -1.057300E-005
'              e: -1.057300e-005
'              F: 0.00
'              G: -1.0573E-05
'              N: 0.00
'              P: 0.00 %
'              R: -1.0573E-05
'          #,000.000: 000.000
'          0.###E-000: -1.057E-005
'          000,000,000,000.00###: -000,000,000,000.00001

Keterangan

Metode memformat ToString(String)Single nilai dalam format tertentu dengan menggunakan konvensi budaya saat ini. Jika Anda ingin menggunakan format default ("G", atau umum) atau menentukan budaya yang berbeda, gunakan kelebihan beban ToString metode lainnya, sebagai berikut:

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

Nilai yang dikembalikan dapat berupa PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol, atau representasi string dari nilai instans saat ini, seperti yang ditentukan oleh format.

Parameter format dapat berupa penentu format numerik standar yang valid kecuali untuk D dan X, serta kombinasi penentu format numerik kustom. Jika format adalah null atau string kosong, nilai yang dikembalikan diformat dengan penentu format numerik umum ("G").

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

Secara default, nilai pengembalian hanya berisi 7 digit presisi meskipun maksimum 9 digit dipertahankan secara internal. Jika nilai instans ini memiliki lebih besar dari 7 digit, ToString(String) mengembalikan atau NegativeInfinitySymbol alih-alih PositiveInfinitySymbol angka yang diharapkan. Jika Anda memerlukan lebih banyak presisi, tentukan format dengan spesifikasi format "G9", yang selalu mengembalikan 9 digit presisi, atau "R", yang mengembalikan 7 digit jika angka dapat diwakili dengan presisi tersebut atau 9 digit jika angka hanya dapat diwakili dengan presisi maksimum.

Lihat juga

Berlaku untuk

ToString(String, IFormatProvider)

Sumber:
Single.cs
Sumber:
Single.cs
Sumber:
Single.cs

Mengonversi nilai numerik instans ini ke representasi string yang setara 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.

provider
IFormatProvider

Objek yang memasok informasi pemformatan khusus budaya.

Mengembalikan

Representasi string dari nilai instans ini seperti yang ditentukan oleh format dan provider.

Penerapan

Contoh

Contoh berikut menampilkan Single nilai menggunakan masing-masing penentu format numerik standar yang didukung untuk beberapa budaya yang berbeda.

float value = 16325.62901F;
string specifier;
CultureInfo culture;

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

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

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,63
culture = CultureInfo.CreateSpecificCulture("en-CA");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325.63

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

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 %
let value = 16325.62901F

// Use standard numeric format specifiers.
let specifier = "G"
let culture = CultureInfo.CreateSpecificCulture "eu-ES"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    16325,62901
printfn $"{value.ToString(specifier, CultureInfo.InvariantCulture)}"
// Displays:    16325.62901

let specifier = "C"
let culture = CultureInfo.CreateSpecificCulture "en-US"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    $16,325.63
let culture = CultureInfo.CreateSpecificCulture "en-GB"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    £16,325.63

let specifier = "E04"
let culture = CultureInfo.CreateSpecificCulture "sv-SE"
printfn $"{value.ToString(specifier, culture)}"
// Displays: 1,6326E+004   
let culture = CultureInfo.CreateSpecificCulture "en-NZ"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    1.6326E+004   

let specifier = "F"
let culture = CultureInfo.CreateSpecificCulture "fr-FR"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    16325,63
let culture = CultureInfo.CreateSpecificCulture "en-CA"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    16325.63

let specifier = "N"
let culture = CultureInfo.CreateSpecificCulture "es-ES"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    16.325,63
let culture = CultureInfo.CreateSpecificCulture "fr-CA"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    16 325,63

let specifier = "P"
let culture = CultureInfo.InvariantCulture
printfn $"{(value / 10000f).ToString(specifier, culture)}"
// Displays:    163.26 %
let culture = CultureInfo.CreateSpecificCulture "ar-EG"
printfn $"{(value / 10000f).ToString(specifier, culture)}"
// Displays:    163.256 %
Dim value As Single = 16325.62901
Dim specifier As String
Dim culture As CultureInfo

' Use standard numeric format specifiers.
specifier = "G"
culture = CultureInfo.CreateSpecificCulture("eu-ES")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325,62901
Console.WriteLine(value.ToString(specifier, CultureInfo.InvariantCulture))
' Displays:    16325.62901

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

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,63
culture = CultureInfo.CreateSpecificCulture("en-CA")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325.63

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

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 %

Keterangan

Metode memformat ToString(String, IFormatProvider)Single nilai dalam format tertentu dari budaya tertentu. Jika Anda ingin menggunakan pengaturan format atau budaya default, gunakan kelebihan beban ToString metode lainnya, sebagai berikut:

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

Nilai yang dikembalikan dapat berupa PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol, atau representasi string dari nilai instans saat ini, seperti yang ditentukan oleh format.

Parameter format dapat berupa penentu format numerik standar yang valid kecuali untuk D dan X, serta kombinasi penentu format numerik kustom. Jika format adalah null atau string kosong, nilai yang dikembalikan untuk instans ini diformat dengan penentu format numerik umum ("G").

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

Parameter provider adalah IFormatProvider implementasi yang metodenya GetFormat mengembalikan NumberFormatInfo objek . Biasanya, provider adalah CultureInfo objek atau NumberFormatInfo objek. Parameter provider memasok informasi khusus budaya yang digunakan dalam pemformatan. Jika provider adalah null, nilai yang dikembalikan diformat dengan NumberFormatInfo objek untuk budaya saat ini.

Secara default, nilai pengembalian hanya berisi 7 digit presisi meskipun maksimum 9 digit dipertahankan secara internal. Jika nilai instans ini memiliki lebih besar dari 7 digit, ToString mengembalikan atau NegativeInfinitySymbol alih-alih PositiveInfinitySymbol angka yang diharapkan. Jika Anda memerlukan lebih banyak presisi, tentukan format dengan spesifikasi format "G9", yang selalu mengembalikan 9 digit presisi, atau "R", yang mengembalikan 7 digit jika angka dapat diwakili dengan presisi tersebut atau 9 digit jika angka hanya dapat diwakili dengan presisi maksimum.

Lihat juga

Berlaku untuk