Single.ToString Metode
Definisi
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 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:
Untuk informasi selengkapnya tentang penentu format numerik, lihat String Format Numerik Standar dan String Format Numerik Kustom.
Untuk informasi selengkapnya tentang pemformatan, lihat Jenis Pemformatan.
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:
Untuk informasi selengkapnya tentang penentu format numerik, lihat String Format Numerik Standar dan String Format Numerik Kustom.
Untuk informasi selengkapnya tentang pemformatan, lihat Jenis Pemformatan.
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:
Untuk informasi selengkapnya tentang penentu format numerik, lihat String Format Numerik Standar dan String Format Numerik Kustom.
Untuk informasi selengkapnya tentang pemformatan, lihat Jenis Pemformatan.
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:
Untuk informasi selengkapnya tentang penentu format numerik, lihat String Format Numerik Standar dan String Format Numerik Kustom.
Untuk informasi selengkapnya tentang pemformatan, lihat Jenis Pemformatan.
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.