Single.TryParse Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Mengonversi representasi string dari angka ke angka floating-point presisi tunggal yang setara. Nilai pengembalian menunjukkan apakah konversi berhasil atau gagal.

Overload

TryParse(String, IFormatProvider, Single)	Mencoba mengurai string ke dalam nilai.
TryParse(ReadOnlySpan<Char>, Single)	Mengonversi representasi string dari angka dalam rentang karakter ke angka floating-point presisi tunggal yang setara. Nilai pengembalian menunjukkan apakah konversi berhasil atau gagal.
TryParse(String, Single)	Mengonversi representasi string dari angka ke angka floating-point presisi tunggal yang setara. Nilai pengembalian menunjukkan apakah konversi berhasil atau gagal.
TryParse(ReadOnlySpan<Byte>, IFormatProvider, Single)	Mencoba mengurai rentang karakter UTF-8 ke dalam nilai.
TryParse(ReadOnlySpan<Char>, IFormatProvider, Single)	Mencoba mengurai rentang karakter menjadi nilai.
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, Single)	Mencoba mengurai rentang karakter UTF-8 ke dalam nilai.
TryParse(ReadOnlySpan<Byte>, Single)	Mencoba mengonversi rentang karakter UTF-8 yang berisi representasi string angka ke angka floating-point presisi tunggal yang setara.
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Single)	Mengonversi representasi rentang angka dalam gaya tertentu dan format khusus budaya ke angka floating-point presisi tunggal yang setara. Nilai pengembalian menunjukkan apakah konversi berhasil atau gagal.
TryParse(String, NumberStyles, IFormatProvider, Single)	Mengonversi representasi string dari angka dalam gaya tertentu dan format khusus budaya ke angka floating-point presisi tunggal yang setara. Nilai pengembalian menunjukkan apakah konversi berhasil atau gagal.

Keterangan

Di .NET Core 3.0 dan yang lebih baru, nilai yang terlalu besar untuk direpresentasikan dibulatkan ke PositiveInfinity atau NegativeInfinity seperti yang diperlukan oleh spesifikasi IEEE 754. Dalam versi sebelumnya, termasuk .NET Framework, mengurai nilai yang terlalu besar untuk mewakili mengakibatkan kegagalan.

TryParse(String, IFormatProvider, Single)

Sumber:

Single.cs

Mencoba mengurai string ke dalam nilai.

public:
 static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] float % result) = IParsable<float>::TryParse;

public static bool TryParse (string? s, IFormatProvider? provider, out float result);

static member TryParse : string * IFormatProvider * single -> bool

Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As Single) As Boolean

Parameter

s

String

String yang akan diurai.

provider

IFormatProvider

Objek yang menyediakan informasi pemformatan khusus budaya tentang s.

result

Single

Ketika metode ini kembali, berisi hasil dari penguraian s yang berhasil atau nilai yang tidak terdefinisi pada kegagalan.

Mengembalikan

Boolean

true jika s berhasil diurai; jika tidak, false.

TryParse(ReadOnlySpan<Char>, Single)

Sumber:

Single.cs

Mengonversi representasi string dari angka dalam rentang karakter ke angka floating-point presisi tunggal yang setara. Nilai pengembalian menunjukkan apakah konversi berhasil atau gagal.

public:
 static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] float % result);

public static bool TryParse (ReadOnlySpan<char> s, out float result);

static member TryParse : ReadOnlySpan<char> * single -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As Single) As Boolean

Parameter

s

ReadOnlySpan<Char>

>Rentang karakter yang berisi representasi string dari angka yang akan dikonversi.

result

Single

Ketika metode ini kembali, berisi angka floating-point presisi tunggal yang setara dengan parameter s, jika konversi berhasil, atau nol jika konversi gagal. Konversi gagal jika parameter snull atau kosong atau bukan angka dalam format yang valid. Jika s adalah angka yang valid kurang dari Single.MinValue , resultNegativeInfinity. Jika s adalah angka yang valid lebih besar dari Single.MaxValue , resultPositiveInfinity. Parameter ini diteruskan tanpa diinisialisasi; nilai apa pun yang awalnya disediakan dalam result akan ditimpa.

Mengembalikan

Boolean

true jika s berhasil dikonversi; jika tidak, false.

Keterangan

Di .NET Core 3.0 dan yang lebih baru, nilai yang terlalu besar untuk direpresentasikan dibulatkan ke PositiveInfinity atau NegativeInfinity seperti yang diperlukan oleh spesifikasi IEEE 754. Dalam versi sebelumnya, termasuk .NET Framework, mengurai nilai yang terlalu besar untuk mewakili mengakibatkan kegagalan.

TryParse(String, Single)

Sumber:

Single.cs

Mengonversi representasi string dari angka ke angka floating-point presisi tunggal yang setara. Nilai pengembalian menunjukkan apakah konversi berhasil atau gagal.

public:
 static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] float % result);

public static bool TryParse (string? s, out float result);

static member TryParse : string * single -> bool

Public Shared Function TryParse (s As String, ByRef result As Single) As Boolean

Parameter

s

String

String yang mewakili angka yang akan dikonversi.

result

Single

Ketika metode ini kembali, berisi angka floating-point presisi tunggal yang setara dengan nilai numerik atau simbol yang terkandung dalam s, jika konversi berhasil, atau nol jika konversi gagal. Konversi gagal jika parameter snull atau Empty atau bukan angka dalam format yang valid. Ini juga gagal pada .NET Framework dan .NET Core 2.2 dan versi yang lebih lama jika s mewakili angka yang kurang dari Single.MinValue atau lebih besar dari Single.MaxValue. Parameter ini diteruskan tanpa diinisialisasi; nilai apa pun yang awalnya disediakan dalam result akan ditimpa.

Mengembalikan

Boolean

true jika s berhasil dikonversi; jika tidak, false.

Contoh

Contoh berikut menggunakan metode TryParse(String, Single) untuk mengonversi representasi string nilai numerik menjadi nilai Single. Ini mengasumsikan bahwa en-US adalah budaya saat ini.

string value;
float number;

// Parse a floating-point value with a thousands separator.
value = "1,643.57";
if (Single.TryParse(value, out number))
   Console.WriteLine(number);
else
   Console.WriteLine("Unable to parse '{0}'.", value);

// Parse a floating-point value with a currency symbol and a
// thousands separator.
value = "$1,643.57";
if (Single.TryParse(value, out number))
   Console.WriteLine(number);
else
   Console.WriteLine("Unable to parse '{0}'.", value);

// Parse value in exponential notation.
value = "-1.643e6";
if (Single.TryParse(value, out number))
   Console.WriteLine(number);
else
   Console.WriteLine("Unable to parse '{0}'.", value);

// Parse a negative integer value.
value = "-168934617882109132";
if (Single.TryParse(value, out number))
   Console.WriteLine(number);
else
   Console.WriteLine("Unable to parse '{0}'.", value);
// The example displays the following output:
//       1643.57
//       Unable to parse '$1,643.57'.
//       -164300
//       -1.689346E+17

// Parse a floating-point value with a thousands separator.
let value = "1,643.57"
match Single.TryParse value with
| true, number ->
    printfn $"{number}"
| _ ->
    printfn $"Unable to parse '{value}'."

// Parse a floating-point value with a currency symbol and a
// thousands separator.
let value = "$1,643.57"
match Single.TryParse value with
| true, number ->
    printfn $"{number}"
| _ ->
    printfn $"Unable to parse '{value}'."

// Parse value in exponential notation.
let value = "-1.643e6"
match Single.TryParse value with
| true, number ->
    printfn $"{number}"
| _ ->
    printfn $"Unable to parse '{value}'."

// Parse a negative integer value.
let value = "-168934617882109132"
match Single.TryParse value with
| true, number ->
    printfn $"{number}"
| _ ->
    printfn $"Unable to parse '{value}'."
// The example displays the following output:
//       1643.57
//       Unable to parse '$1,643.57'.
//       -164300
//       -1.689346E+17

Dim value As String
Dim number As Single

' Parse a floating-point value with a thousands separator.
value = "1,643.57"
If Single.TryParse(value, number) Then
   Console.WriteLine(number)
Else
   Console.WriteLine("Unable to parse '{0}'.", value)
End If

' Parse a floating-point value with a currency symbol and a
' thousands separator.
value = "$1,643.57"
If Single.TryParse(value, number) Then
   Console.WriteLine(number)
Else
   Console.WriteLine("Unable to parse '{0}'.", value)
End If

' Parse value in exponential notation.
value = "-1.643e6"
If Single.TryParse(value, number)
   Console.WriteLine(number)
Else
   Console.WriteLine("Unable to parse '{0}'.", value)
End If

' Parse a negative integer number.
value = "-168934617882109132"
If Single.TryParse(value, number)
   Console.WriteLine(number)
Else
   Console.WriteLine("Unable to parse '{0}'.", value)
End If
' The example displays the following output:
'       1643.57
'       Unable to parse '$1,643.57'.
'       -1643000
'       -1.689346E+17

Keterangan

Di .NET Core 3.0 dan yang lebih baru, nilai yang terlalu besar untuk direpresentasikan dibulatkan ke PositiveInfinity atau NegativeInfinity seperti yang diperlukan oleh spesifikasi IEEE 754. Dalam versi sebelumnya, termasuk .NET Framework, mengurai nilai yang terlalu besar untuk mewakili mengakibatkan kegagalan.

Kelebihan beban ini berbeda dari metode Single.Parse(String) dengan mengembalikan nilai Boolean yang menunjukkan apakah operasi penguraian berhasil alih-alih mengembalikan nilai numerik yang diurai. Ini menghilangkan kebutuhan untuk menggunakan penanganan pengecualian untuk menguji FormatException jika s tidak valid dan tidak dapat berhasil diurai.

Parameter s dapat berisi PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol (perbandingan string peka huruf besar/kecil), atau string formulir:

[ws] [tanda tangan] [integral-digits,]integral-digits[.[ fractional-digits]][e[sign]exponential-digits][ws]

Elemen dalam tanda kurung siku bersifat opsional. Tabel berikut ini menjelaskan setiap elemen.

Elemen	Deskripsi
ws	Serangkaian karakter spasi putih.
tanda tangan	Tanda negatif atau simbol tanda positif.
digit integral	Serangkaian karakter numerik mulai dari 0 hingga 9 yang menentukan bagian integral dari angka. Digit integral dapat tidak ada jika ada digit pecahan.
,	Simbol pemisah grup khusus budaya.
.	Simbol titik desimal khusus budaya.
digit pecahan	Serangkaian karakter numerik mulai dari 0 hingga 9 yang menentukan bagian pecahan dari angka.
E	Karakter huruf besar atau kecil 'e', yang menunjukkan notasi eksponensial (ilmiah).
digit eksponensial	Serangkaian karakter numerik mulai dari 0 hingga 9 yang menentukan eksponen.

Parameter s ditafsirkan menggunakan kombinasi bendera NumberStyles.Float dan NumberStyles.AllowThousands. Ini berarti bahwa ruang kosong dan ribuan pemisah diizinkan tetapi simbol mata uang tidak. Untuk secara eksplisit menentukan elemen (seperti simbol mata uang, ribuan pemisah, dan spasi putih) yang dapat ada di s, gunakan metode TryParse(String, NumberStyles, IFormatProvider, Single) kelebihan beban.

Parameter s diurai menggunakan informasi pemformatan dalam objek NumberFormatInfo yang diinisialisasi untuk budaya sistem saat ini. Untuk informasi selengkapnya, lihat NumberFormatInfo.CurrentInfo. Untuk mengurai string menggunakan informasi pemformatan dari beberapa budaya tertentu lainnya, gunakan metode TryParse(String, NumberStyles, IFormatProvider, Single) kelebihan beban.

Biasanya, jika Anda meneruskan metode Single.TryParse string yang dibuat dengan memanggil metode Single.ToString, nilai Single asli dikembalikan. Namun, karena hilangnya presisi, nilainya mungkin tidak sama.

Jika s berada di luar rentang jenis data Single, metode mengembalikan false pada .NET Framework dan .NET Core 2.2 dan versi yang lebih lama. Pada .NET Core 3.0 dan versi yang lebih baru, ia mengembalikan Single.NegativeInfinity jika s kurang dari Single.MinValue dan Single.PositiveInfinity jika s lebih besar dari Single.MaxValue.

Jika pemisah ditemui dalam parameter s selama operasi penguraian, dan pemisah mata uang atau angka yang berlaku dan pemisah grup sama, operasi penguraian mengasumsikan bahwa pemisah adalah pemisah desimal daripada pemisah grup. Untuk informasi selengkapnya tentang pemisah, lihat CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparator, dan NumberGroupSeparator.

Lihat juga

• Parse(String)
• ToString()
• Mengurai String Numerik di .NET

TryParse(ReadOnlySpan<Byte>, IFormatProvider, Single)

Sumber:

Single.cs

Mencoba mengurai rentang karakter UTF-8 ke dalam nilai.

public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, IFormatProvider ^ provider, [Runtime::InteropServices::Out] float % result) = IUtf8SpanParsable<float>::TryParse;

public static bool TryParse (ReadOnlySpan<byte> utf8Text, IFormatProvider? provider, out float result);

static member TryParse : ReadOnlySpan<byte> * IFormatProvider * single -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider, ByRef result As Single) As Boolean

Parameter

utf8Text

ReadOnlySpan<Byte>

Rentang karakter UTF-8 untuk diurai.

provider

IFormatProvider

Objek yang menyediakan informasi pemformatan khusus budaya tentang utf8Text.

result

Single

Saat dikembalikan, berisi hasil dari penguraian utf8Text yang berhasil atau nilai yang tidak terdefinisi pada kegagalan.

Mengembalikan

Boolean

true jika utf8Text berhasil diurai; jika tidak, false.

TryParse(ReadOnlySpan<Char>, IFormatProvider, Single)

Sumber:

Single.cs

Mencoba mengurai rentang karakter menjadi nilai.

public:
 static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] float % result) = ISpanParsable<float>::TryParse;

public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider? provider, out float result);

static member TryParse : ReadOnlySpan<char> * IFormatProvider * single -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As Single) As Boolean

Parameter

s

ReadOnlySpan<Char>

Rentang karakter untuk diurai.

provider

IFormatProvider

Objek yang menyediakan informasi pemformatan khusus budaya tentang s.

result

Single

Ketika metode ini kembali, berisi hasil penguraian yang berhasil s, atau nilai yang tidak ditentukan pada kegagalan.

Mengembalikan

Boolean

true jika s berhasil diurai; jika tidak, false.

TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, Single)

Sumber:

Single.cs

Mencoba mengurai rentang karakter UTF-8 ke dalam nilai.

public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] float % result) = System::Numerics::INumberBase<float>::TryParse;

public static bool TryParse (ReadOnlySpan<byte> utf8Text, System.Globalization.NumberStyles style, IFormatProvider? provider, out float result);

static member TryParse : ReadOnlySpan<byte> * System.Globalization.NumberStyles * IFormatProvider * single -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), style As NumberStyles, provider As IFormatProvider, ByRef result As Single) As Boolean

Parameter

utf8Text

ReadOnlySpan<Byte>

Rentang karakter UTF-8 untuk diurai.

style

NumberStyles

Kombinasi bitwise dari gaya angka yang dapat ada di utf8Text.

provider

IFormatProvider

Objek yang menyediakan informasi pemformatan khusus budaya tentang utf8Text.

result

Single

Saat dikembalikan, berisi hasil dari penguraian utf8Text yang berhasil atau nilai yang tidak terdefinisi pada kegagalan.

Mengembalikan

Boolean

true jika utf8Text berhasil diurai; jika tidak, false.

TryParse(ReadOnlySpan<Byte>, Single)

Sumber:

Single.cs

Mencoba mengonversi rentang karakter UTF-8 yang berisi representasi string angka ke angka floating-point presisi tunggal yang setara.

public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, [Runtime::InteropServices::Out] float % result);

public static bool TryParse (ReadOnlySpan<byte> utf8Text, out float result);

static member TryParse : ReadOnlySpan<byte> * single -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), ByRef result As Single) As Boolean

Parameter

utf8Text

ReadOnlySpan<Byte>

Rentang karakter UTF-8 baca-saja yang berisi angka yang akan dikonversi.

result

Single

Ketika metode ini kembali, berisi angka floating-point presisi tunggal yang setara dengan nilai numerik atau simbol yang terkandung dalam utf8Text jika konversi berhasil atau nol jika konversi gagal. Konversi gagal jika utf8TextEmpty atau tidak dalam format yang valid. Parameter ini diteruskan tanpa diinisialisasi; nilai apa pun yang awalnya disediakan dalam hasil akan ditimpa.

Mengembalikan

Boolean

true jika utf8Text berhasil dikonversi; jika tidak, false.

TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Single)

Sumber:

Single.cs

Mengonversi representasi rentang angka dalam gaya tertentu dan format khusus budaya ke angka floating-point presisi tunggal yang setara. Nilai pengembalian menunjukkan apakah konversi berhasil atau gagal.

public:
 static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] float % result) = System::Numerics::INumberBase<float>::TryParse;

public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out float result);

static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * single -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As Single) As Boolean

Parameter

s

ReadOnlySpan<Char>

Rentang karakter baca-saja yang berisi angka yang akan dikonversi. Rentang ditafsirkan menggunakan gaya yang ditentukan oleh style.

style

NumberStyles

Kombinasi bitwise dari nilai enumerasi yang menunjukkan format syang diizinkan. Nilai umum yang ditentukan adalah Float dikombinasikan dengan AllowThousands.

provider

IFormatProvider

Objek yang memasok informasi pemformatan khusus budaya tentang s.

result

Single

Ketika metode ini kembali, berisi angka floating-point presisi tunggal yang setara dengan nilai numerik atau simbol yang terkandung dalam s, jika konversi berhasil, atau nol jika konversi gagal. Konversi gagal jika parameter snull atau Empty, tidak sesuai format dengan style, mewakili angka yang kurang dari Single.MinValue atau lebih besar dari Single.MaxValue , atau jika style bukan kombinasi valid dari konstanta enumerasi NumberStyles. Parameter ini diteruskan tanpa diinisialisasi; nilai apa pun yang awalnya disediakan dalam result akan ditimpa.

Mengembalikan

Boolean

true jika s berhasil dikonversi; jika tidak, false.

Keterangan

Di .NET Core 3.0 dan yang lebih baru, nilai yang terlalu besar untuk direpresentasikan dibulatkan ke PositiveInfinity atau NegativeInfinity seperti yang diperlukan oleh spesifikasi IEEE 754. Dalam versi sebelumnya, termasuk .NET Framework, mengurai nilai yang terlalu besar untuk mewakili mengakibatkan kegagalan.

TryParse(String, NumberStyles, IFormatProvider, Single)

Sumber:

Single.cs

Mengonversi representasi string dari angka dalam gaya tertentu dan format khusus budaya ke angka floating-point presisi tunggal yang setara. Nilai pengembalian menunjukkan apakah konversi berhasil atau gagal.

public:
 static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] float % result) = System::Numerics::INumberBase<float>::TryParse;

public static bool TryParse (string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out float result);

static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * single -> bool

Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As Single) As Boolean

Parameter

s

String

String yang mewakili angka yang akan dikonversi.

style

NumberStyles

Kombinasi bitwise dari nilai enumerasi yang menunjukkan format syang diizinkan. Nilai umum yang ditentukan adalah Float dikombinasikan dengan AllowThousands.

provider

IFormatProvider

Objek yang memasok informasi pemformatan khusus budaya tentang s.

result

Single

Ketika metode ini kembali, berisi angka floating-point presisi tunggal yang setara dengan nilai numerik atau simbol yang terkandung dalam s, jika konversi berhasil, atau nol jika konversi gagal. Konversi gagal jika parameter snull atau Empty, tidak sesuai dengan format style, atau jika style bukan kombinasi konstanta enumerasi NumberStyles yang valid. Ini juga gagal pada .NET Framework atau .NET Core 2.2 dan versi yang lebih lama jika s mewakili angka yang kurang dari Single.MinValue atau lebih besar dari Single.MaxValue. Parameter ini diteruskan tanpa diinisialisasi; nilai apa pun yang awalnya disediakan dalam result akan ditimpa.

Mengembalikan

Boolean

true jika s berhasil dikonversi; jika tidak, false.

Pengecualian

ArgumentException

style bukan nilai NumberStyles.

-atau-

style adalah nilai AllowHexSpecifier.

Contoh

Contoh berikut menunjukkan penggunaan metode Single.TryParse(String, NumberStyles, IFormatProvider, Single) untuk mengurai representasi string angka yang memiliki gaya tertentu dan diformat menggunakan konvensi budaya tertentu.

string value;
System.Globalization.NumberStyles style;
System.Globalization.CultureInfo culture;
float number;

// Parse currency value using en-GB culture.
value = "£1,097.63";
style = System.Globalization.NumberStyles.Number |
        System.Globalization.NumberStyles.AllowCurrencySymbol;
culture = System.Globalization.CultureInfo.CreateSpecificCulture("en-GB");
if (Single.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);

value = "1345,978";
style = System.Globalization.NumberStyles.AllowDecimalPoint;
culture = System.Globalization.CultureInfo.CreateSpecificCulture("fr-FR");
if (Single.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);

value = "1.345,978";
style = System.Globalization.NumberStyles.AllowDecimalPoint |
        System.Globalization.NumberStyles.AllowThousands;
culture = System.Globalization.CultureInfo.CreateSpecificCulture("es-ES");
if (Single.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);

value = "1 345,978";
if (Single.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);
// The example displays the following output:
//       Converted '£1,097.63' to 1097.63.
//       Converted '1345,978' to 1345.978.
//       Converted '1.345,978' to 1345.978.
//       Unable to convert '1 345,978'.

// Parse currency value using en-GB culture.
let value = "£1,097.63"
let style = System.Globalization.NumberStyles.Number ||| System.Globalization.NumberStyles.AllowCurrencySymbol
let culture = System.Globalization.CultureInfo.CreateSpecificCulture "en-GB"
match Single.TryParse(value, style, culture) with
| true, number ->
    printfn $"Converted '{value}' to {number}."
| _ ->
    printfn $"Unable to convert '{value}'."

let value = "1345,978"
let style = System.Globalization.NumberStyles.AllowDecimalPoint
let culture = System.Globalization.CultureInfo.CreateSpecificCulture "fr-FR"
match Single.TryParse(value, style, culture) with
| true, number ->
    printfn $"Converted '{value}' to {number}."
| _ ->
    printfn $"Unable to convert '{value}'."

let value = "1.345,978"
let style = System.Globalization.NumberStyles.AllowDecimalPoint ||| System.Globalization.NumberStyles.AllowThousands
let culture = System.Globalization.CultureInfo.CreateSpecificCulture "es-ES"
match Single.TryParse(value, style, culture) with
| true, number ->
    printfn $"Converted '{value}' to {number}."
| _ ->
    printfn $"Unable to convert '{value}'."

let value = "1 345,978"
match Single.TryParse(value, style, culture) with
| true, number ->
    printfn $"Converted '{value}' to {number}."
| _ ->
    printfn $"Unable to convert '{value}'."
// The example displays the following output:
//       Converted '£1,097.63' to 1097.63.
//       Converted '1345,978' to 1345.978.
//       Converted '1.345,978' to 1345.978.
//       Unable to convert '1 345,978'.

Dim value As String
Dim style As System.Globalization.NumberStyles
Dim culture As System.Globalization.CultureInfo
Dim number As Single

' Parse currency value using en-GB culture.
value = "£1,097.63"
style = System.Globalization.NumberStyles.Number Or _
        System.Globalization.NumberStyles.AllowCurrencySymbol
culture = System.Globalization.CultureInfo.CreateSpecificCulture("en-GB")
If Single.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If

value = "1345,978"
style = System.Globalization.NumberStyles.AllowDecimalPoint
culture = System.Globalization.CultureInfo.CreateSpecificCulture("fr-FR")
If Single.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If

value = "1.345,978"
style = System.Globalization.NumberStyles.AllowDecimalPoint Or _
        System.Globalization.NumberStyles.AllowThousands
culture = System.Globalization.CultureInfo.CreateSpecificCulture("es-ES")
If Single.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If

value = "1 345,978"
If Single.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If
' The example displays the following output:
'       Converted '£1,097.63' to 1097.63.
'       Converted '1345,978' to 1345.978.
'       Converted '1.345,978' to 1345.978.
'       Unable to convert '1 345,978'.

Keterangan

Di .NET Core 3.0 dan yang lebih baru, nilai yang terlalu besar untuk direpresentasikan dibulatkan ke PositiveInfinity atau NegativeInfinity seperti yang diperlukan oleh spesifikasi IEEE 754. Dalam versi sebelumnya, termasuk .NET Framework, mengurai nilai yang terlalu besar untuk mewakili mengakibatkan kegagalan.

Kelebihan beban ini berbeda dari metode Parse(String, NumberStyles, IFormatProvider) dengan mengembalikan nilai Boolean yang menunjukkan apakah operasi penguraian berhasil alih-alih mengembalikan nilai numerik yang diurai. Ini menghilangkan kebutuhan untuk menggunakan penanganan pengecualian untuk menguji FormatException jika s tidak valid dan tidak dapat berhasil diurai.

Parameter style menentukan format parameter s yang diizinkan agar operasi penguraian berhasil. Ini harus merupakan kombinasi bendera bit dari enumerasi NumberStyles. Anggota NumberStyles berikut ini tidak didukung:

• NumberStyles.AllowHexSpecifier

• NumberStyles.HexNumber

Parameter s dapat berisi PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol untuk budaya yang ditunjukkan oleh provider. Selain itu, tergantung pada nilai style, parameter s dapat mencakup elemen-elemen berikut:

[ws] [$] [tanda tangan] [integral-digits,]integral-digits[.fractional-digits][e[sign]exponential-digits][ws]

Elemen dalam tanda kurung siku ([ dan ]) bersifat opsional. Tabel berikut ini menjelaskan setiap elemen.

Elemen	Deskripsi
ws	Spasi kosong opsional. Spasi kosong dapat muncul di awal s jika style menyertakan bendera NumberStyles.AllowLeadingWhite. Ini dapat muncul di akhir s jika style menyertakan bendera NumberStyles.AllowTrailingWhite.
$	Simbol mata uang khusus budaya. Posisinya dalam string didefinisikan oleh properti NumberFormatInfo.CurrencyNegativePattern atau NumberFormatInfo.CurrencyPositivePattern objek NumberFormatInfo yang dikembalikan oleh metode IFormatProvider.GetFormat parameter provider. Simbol mata uang dapat muncul dalam s jika style menyertakan bendera NumberStyles.AllowCurrencySymbol.
tanda tangan	Tanda opsional. Tanda dapat muncul di awal s jika style menyertakan bendera NumberStyles.AllowLeadingSign, dan dapat muncul di akhir s jika style menyertakan bendera NumberStyles.AllowTrailingSign. Tanda kurung dapat digunakan dalam s untuk menunjukkan nilai negatif jika style menyertakan bendera NumberStyles.AllowParentheses.
digit integral	Serangkaian digit mulai dari 0 hingga 9 yang menentukan bagian integral dari angka. Digit integral dapat tidak ada jika ada digit pecahan.
,	Simbol pemisah ribuan khusus budaya. Simbol pemisah ribuan budaya saat ini dapat muncul di s jika style menyertakan bendera NumberStyles.AllowThousands.
.	Simbol titik desimal khusus budaya. Simbol titik desimal budaya saat ini dapat muncul di s jika style menyertakan bendera NumberStyles.AllowDecimalPoint.
digit pecahan	Serangkaian digit mulai dari 0 hingga 9 yang menentukan bagian pecahan dari angka. Digit pecahan dapat muncul di s jika style menyertakan bendera NumberStyles.AllowDecimalPoint.
e	Karakter e atau E, yang menunjukkan bahwa s dapat mewakili angka menggunakan notasi eksponensial. Parameter s dapat mewakili angka dalam notasi eksponensial jika gaya menyertakan bendera NumberStyles.AllowExponent.
digit eksponensial	Serangkaian digit mulai dari 0 hingga 9 yang menentukan eksponen.

Nota

Karakter NUL (U+0000) yang mengakhiri di s diabaikan oleh operasi penguraian, terlepas dari nilai argumen style.

String dengan digit saja (yang sesuai dengan gaya NumberStyles.None) selalu berhasil diurai jika berada dalam rentang jenis Single. Elemen kontrol anggota System.Globalization.NumberStyles yang tersisa yang mungkin tetapi tidak diperlukan untuk hadir dalam string input. Tabel berikut menunjukkan bagaimana bendera NumberStyles individual memengaruhi elemen yang mungkin ada di s.

Nilai NumberStyles	Elemen yang diizinkan dalam s selain digit
None	Elemen integral-digits saja.
AllowDecimalPoint	. dan elemen pecahan.
AllowExponent	Parameter s juga dapat menggunakan notasi eksponensial. Bendera ini dengan sendirinya mendukung nilai dalam formulir digit integralEdigit eksponensial; bendera tambahan diperlukan untuk berhasil mengurai string dalam notasi eksponensial dengan elemen seperti tanda positif atau negatif dan simbol titik desimal.
AllowLeadingWhite	Elemen ws di awal s.
AllowTrailingWhite	Elemen ws di akhir .
AllowLeadingSign	Elemen tanda tangan di awal .
AllowTrailingSign	Elemen tanda tangan di akhir .
AllowParentheses	Elemen tanda dalam bentuk tanda kurung yang mencakup nilai numerik.
AllowThousands	Elemen ,.
AllowCurrencySymbol	Elemen $.
Currency	Semua. Parameter s tidak dapat mewakili angka heksadesimal atau angka dalam notasi eksponensial.
Float	Elemen ws di awal atau akhir s, menandatangani di awal s, dan . simbol. Parameter s juga dapat menggunakan notasi eksponensial.
Number	ws, sign, ribuan pemisah (, ), dan titik desimal (.) elemen.
Any	Semua gaya, kecuali s tidak dapat mewakili angka heksadesimal.

Parameter provider adalah implementasi IFormatProvider yang metode GetFormat-nya mengembalikan objek NumberFormatInfo yang menyediakan informasi pemformatan khusus budaya. Ketika metode TryParse(String, NumberStyles, IFormatProvider, Single) 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 tentang format parameter s. Ada tiga cara untuk menggunakan parameter provider untuk menyediakan informasi pemformatan kustom ke operasi penguraian:

• 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 s ditafsirkan berdasarkan objek NumberFormatInfo budaya saat ini.

Jika s berada di luar rentang jenis data Single, metode melemparkan OverflowException pada .NET Framework dan .NET Core 2.2 dan versi yang lebih lama. Pada .NET Core 3.0 dan versi yang lebih baru, ia mengembalikan Single.NegativeInfinity jika s kurang dari Single.MinValue dan Single.PositiveInfinity jika s lebih besar dari Single.MaxValue.

Jika pemisah ditemui dalam parameter s selama operasi penguraian, dan pemisah mata uang atau angka yang berlaku dan pemisah grup sama, operasi penguraian mengasumsikan bahwa pemisah adalah pemisah desimal daripada pemisah grup. Untuk informasi selengkapnya tentang pemisah, lihat CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparator, dan NumberGroupSeparator.

Lihat juga

• Parse(String)
• ToString()
• Mengurai String Numerik di .NET