Single.Parse Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Konwertuje ciąg reprezentujący liczbę na odpowiadającą mu liczbę zmiennoprzecinkową pojedynczej precyzji.
Przeciążenia
Parse(String) |
Konwertuje ciąg reprezentujący liczbę na odpowiadającą mu liczbę zmiennoprzecinkową pojedynczej precyzji. |
Parse(ReadOnlySpan<Byte>, IFormatProvider) |
Analizuje zakres znaków UTF-8 w wartość. |
Parse(ReadOnlySpan<Char>, IFormatProvider) |
Analizuje zakres znaków w wartości. |
Parse(String, NumberStyles) |
Konwertuje reprezentację ciągu liczby w określonym stylu na odpowiednik liczb zmiennoprzecinkowych o pojedynczej precyzji. |
Parse(String, IFormatProvider) |
Konwertuje reprezentację ciągu liczby w określonym formacie specyficznym dla kultury na odpowiednik liczb zmiennoprzecinkowych o pojedynczej precyzji. |
Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider) |
Analizuje zakres znaków UTF-8 w wartość. |
Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) |
Konwertuje zakres znaków zawierający reprezentację ciągu liczby w określonym stylu i formacie specyficznym dla kultury na odpowiednik liczby zmiennoprzecinkowych o pojedynczej precyzji. |
Parse(String, NumberStyles, IFormatProvider) |
Konwertuje reprezentację ciągu liczby w określonym stylu i formacie specyficznym dla kultury na odpowiednik liczb zmiennoprzecinkowych o pojedynczej precyzji. |
Uwagi
W programie .NET Core 3.0 lub nowszym wartości, które są zbyt duże do reprezentowania, są zaokrąglane do PositiveInfinity lub NegativeInfinity zgodnie ze specyfikacją IEEE 754. W poprzednich wersjach, w tym .NET Framework, analizowanie wartości, która była zbyt duża, aby reprezentować, spowodowało niepowodzenie.
Parse(String)
- Źródło:
- Single.cs
- Źródło:
- Single.cs
- Źródło:
- Single.cs
Konwertuje ciąg reprezentujący liczbę na odpowiadającą mu liczbę zmiennoprzecinkową pojedynczej precyzji.
public:
static float Parse(System::String ^ s);
public static float Parse (string s);
static member Parse : string -> single
Public Shared Function Parse (s As String) As Single
Parametry
- s
- String
Ciąg zawierający liczbę, którą należy przekształcić.
Zwraca
Liczba zmiennoprzecinkowa o pojedynczej precyzji równoważna wartości liczbowej lub symbolowi określonemu w elemencie s
.
Wyjątki
s
to null
.
s
nie reprezentuje liczby w prawidłowym formacie.
.NET Framework i .NET Core 2.2 i starsze wersje: s
reprezentuje tylko liczbę mniejszą niż Single.MinValue lub większa niż Single.MaxValue.
Przykłady
W poniższym przykładzie Parse(String) użyto metody , aby przekonwertować tablicę ciągów na równoważne Single wartości.
using System;
public class Example
{
public static void Main()
{
string[] values = { "100", "(100)", "-123,456,789", "123.45e+6",
"+500", "5e2", "3.1416", "600.", "-.123",
"-Infinity", "-1E-16", Double.MaxValue.ToString(),
Single.MinValue.ToString(), String.Empty };
foreach (string value in values)
{
try {
float number = Single.Parse(value);
Console.WriteLine("{0} -> {1}", value, number);
}
catch (FormatException) {
Console.WriteLine("'{0}' is not in a valid format.", value);
}
catch (OverflowException) {
Console.WriteLine("{0} is outside the range of a Single.", value);
}
}
}
}
// The example displays the following output:
// 100 -> 100
// '(100)' is not in a valid format.
// -123,456,789 -> -1.234568E+08
// 123.45e+6 -> 1.2345E+08
// +500 -> 500
// 5e2 -> 500
// 3.1416 -> 3.1416
// 600. -> 600
// -.123 -> -0.123
// -Infinity -> -Infinity
// -1E-16 -> -1E-16
// 1.79769313486232E+308 is outside the range of a Single.
// -3.402823E+38 -> -3.402823E+38
// '' is not in a valid format.
open System
let values =
[| "100"; "(100)"; "-123,456,789"; "123.45e+6"
"+500"; "5e2"; "3.1416"; "600."; "-.123"
"-Infinity"; "-1E-16"; string Double.MaxValue
string Single.MinValue; String.Empty |]
for value in values do
try
let number = Single.Parse value
printfn $"{value} -> {number}"
with
| :? FormatException ->
printfn $"'{value}' is not in a valid format."
| :? OverflowException ->
printfn $"{value} is outside the range of a Single."
// The example displays the following output:
// 100 -> 100
// '(100)' is not in a valid format.
// -123,456,789 -> -1.234568E+08
// 123.45e+6 -> 1.2345E+08
// +500 -> 500
// 5e2 -> 500
// 3.1416 -> 3.1416
// 600. -> 600
// -.123 -> -0.123
// -Infinity -> -Infinity
// -1E-16 -> -1E-16
// 1.79769313486232E+308 is outside the range of a Single.
// -3.402823E+38 -> -3.402823E+38
// '' is not in a valid format.
Module Example
Public Sub Main()
Dim values() As String = { "100", "(100)", "-123,456,789", "123.45e+6", _
"+500", "5e2", "3.1416", "600.", "-.123", _
"-Infinity", "-1E-16", Double.MaxValue.ToString(), _
Single.MinValue.ToString(), String.Empty }
For Each value As String In values
Try
Dim number As Single = Single.Parse(value)
Console.WriteLine("{0} -> {1}", value, number)
Catch e As FormatException
Console.WriteLine("'{0}' is not in a valid format.", value)
Catch e As OverflowException
Console.WriteLine("{0} is outside the range of a Single.", value)
End Try
Next
End Sub
End Module
' The example displays the following output:
' 100 -> 100
' '(100)' is not in a valid format.
' -123,456,789 -> -1.234568E+08
' 123.45e+6 -> 1.2345E+08
' +500 -> 500
' 5e2 -> 500
' 3.1416 -> 3.1416
' 600. -> 600
' -.123 -> -0.123
' -Infinity -> -Infinity
' -1E-16 -> -1E-16
' 1.79769313486232E+308 is outside the range of a Single.
' -3.402823E+38 -> -3.402823E+38
' '' is not in a valid format.
Uwagi
W programie .NET Core 3.0 i nowszych wartości, które są zbyt duże do reprezentowania, są zaokrąglane do PositiveInfinity lub NegativeInfinity zgodnie z wymaganiami specyfikacji IEEE 754. W poprzednich wersjach, w tym .NET Framework, analizowanie wartości, która była zbyt duża, aby reprezentować wynik awarii.
Parametr s
może zawierać ciąg formularza , NegativeInfinitySymbol, NaNSymbollub bieżącej kulturyPositiveInfinitySymbol:
[ws] [znak] [cyfry całkowite[,]] cyfry całkowite[.[cyfry ułamkowe]] [e[znak]cyfry wykładnicze] [ws]
Elementy w nawiasach kwadratowych ([ i ]) są opcjonalne. W tabeli poniżej opisano każdy element.
Element | Opis |
---|---|
Ws | Seria znaków białych znaków. |
sign | Symbol znaku ujemnego lub symbol znaku dodatniego. Prawidłowe znaki są określane przez NumberFormatInfo.NegativeSign właściwości i NumberFormatInfo.PositiveSign bieżącej kultury. Można użyć tylko znaku wiodącego. |
cyfry-całkowite | Ciąg cyfr od 0 do 9, które określają jej część całkowitą. Przebiegi cyfr całkowitych można podzielić na partycje za pomocą symbolu separatora grup. Na przykład w niektórych kulturach przecinek (,) oddziela grupy wartości tysięcznych. Element całkowitocyfrowy może być nieobecny , jeśli ciąg zawiera element ułamkowej cyfry . |
, | Symbol separatora tysięcy specyficzny dla kultury. |
. | Symbol dziesiętny specyficzny dla kultury. |
cyfry-ułamkowe | Ciąg cyfr od 0 do 9, które określają część ułamkową liczby. |
E | Znak „e” lub „E”, który wskazuje, że wartość jest reprezentowana w zapisie wykładniczym (naukowym). |
cyfry-wykładnicze | Ciąg cyfr od 0 do 9, które określają wykładnik potęgi. |
Parametr s
jest interpretowany przy użyciu kombinacji NumberStyles.Float flag i NumberStyles.AllowThousands . Oznacza to, że biały znak i separatory tysięczne są dozwolone, ale symbole walut nie. Aby jawnie zdefiniować elementy (takie jak symbole waluty, separatory tysięcy i odstępy), które mogą być obecne w s
programie , użyj Parse(String, NumberStyles) przeciążenia metody.
Parametr s
jest analizowany przy użyciu informacji o formatowaniu w obiekcie zainicjowanym NumberFormatInfo dla bieżącej kultury systemu. Aby uzyskać więcej informacji, zobacz CurrentInfo. Aby przeanalizować ciąg przy użyciu informacji o formatowaniu określonej kultury, użyj Parse(String, IFormatProvider) metody or Parse(String, NumberStyles, IFormatProvider) .
Zwykle, jeśli przekazujesz Parse metodę ciąg, który jest tworzony przez wywołanie ToString metody, zwracana jest oryginalna Single wartość. Jednak ze względu na utratę precyzji wartości mogą być różne.
Jeśli s
jest poza zakresem Single typu danych, metoda zgłasza OverflowException wartość w .NET Framework i .NET Core 2.2 i starszych wersjach. W programie .NET Core 3.0 i nowszych wersjach zwraca wartość Single.NegativeInfinity , jeśli s
jest mniejsza niż i Single.PositiveInfinity jeśli s
jest większa niż Single.MaxValueSingle.MinValue .
Jeśli separator napotkany w parametrze s
podczas operacji analizy, a odpowiednia waluta lub separatory liczb dziesiętne i separatory grup są takie same, operacja analizy zakłada, że separator jest separatorem dziesiętnym, a nie separatorem grupy. Aby uzyskać więcej informacji na temat separatorów, zobacz CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparatori NumberGroupSeparator.
Zobacz też
Dotyczy
Parse(ReadOnlySpan<Byte>, IFormatProvider)
- Źródło:
- Single.cs
- Źródło:
- Single.cs
Analizuje zakres znaków UTF-8 w wartość.
public:
static float Parse(ReadOnlySpan<System::Byte> utf8Text, IFormatProvider ^ provider) = IUtf8SpanParsable<float>::Parse;
public static float Parse (ReadOnlySpan<byte> utf8Text, IFormatProvider? provider);
static member Parse : ReadOnlySpan<byte> * IFormatProvider -> single
Public Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider) As Single
Parametry
- utf8Text
- ReadOnlySpan<Byte>
Zakres znaków UTF-8 do przeanalizowania.
- provider
- IFormatProvider
Obiekt, który udostępnia informacje o formatowaniu specyficznym dla kultury dotyczące utf8Text
elementu .
Zwraca
Wynik analizy utf8Text
.
Implementuje
Dotyczy
Parse(ReadOnlySpan<Char>, IFormatProvider)
- Źródło:
- Single.cs
- Źródło:
- Single.cs
- Źródło:
- Single.cs
Analizuje zakres znaków w wartości.
public:
static float Parse(ReadOnlySpan<char> s, IFormatProvider ^ provider) = ISpanParsable<float>::Parse;
public static float Parse (ReadOnlySpan<char> s, IFormatProvider? provider);
static member Parse : ReadOnlySpan<char> * IFormatProvider -> single
Public Shared Function Parse (s As ReadOnlySpan(Of Char), provider As IFormatProvider) As Single
Parametry
- s
- ReadOnlySpan<Char>
Zakres znaków do przeanalizowania.
- provider
- IFormatProvider
Obiekt, który udostępnia informacje o formatowaniu specyficznym dla kultury dotyczące s
elementu .
Zwraca
Wynik analizy s
.
Implementuje
Dotyczy
Parse(String, NumberStyles)
- Źródło:
- Single.cs
- Źródło:
- Single.cs
- Źródło:
- Single.cs
Konwertuje reprezentację ciągu liczby w określonym stylu na równoważność liczb zmiennoprzecinkowych o pojedynczej precyzji.
public:
static float Parse(System::String ^ s, System::Globalization::NumberStyles style);
public static float Parse (string s, System.Globalization.NumberStyles style);
static member Parse : string * System.Globalization.NumberStyles -> single
Public Shared Function Parse (s As String, style As NumberStyles) As Single
Parametry
- s
- String
Ciąg zawierający liczbę, którą należy przekształcić.
- style
- NumberStyles
Bitowa kombinacja wartości wyliczenia, która wskazuje elementy stylu, które mogą być obecne w obiekcie s
. Typowa wartość do określenia jest Float połączona z elementem AllowThousands.
Zwraca
Liczba zmiennoprzecinkowa o pojedynczej precyzji, która jest równoważna wartości liczbowej lub symbolowi określonemu w elemencie s
.
Wyjątki
s
to null
.
s
nie jest liczbą w prawidłowym formacie.
.NET Framework i .NET Core 2.2 i starsze wersje: s
reprezentuje tylko liczbę, która jest mniejsza niż Single.MinValue lub większa niż Single.MaxValue.
Przykłady
W poniższym przykładzie Parse(String, NumberStyles) użyto metody , aby przeanalizować reprezentacje ciągów Single wartości. W przykładzie użyto informacji o formatowaniu dla kultury en-US.
using System;
using System.Globalization;
using System.Threading;
public class ParseString
{
public static void Main()
{
// Set current thread culture to en-US.
Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("en-US");
string value;
NumberStyles styles;
// Parse a string in exponential notation with only the AllowExponent flag.
value = "-1.063E-02";
styles = NumberStyles.AllowExponent;
ShowNumericValue(value, styles);
// Parse a string in exponential notation
// with the AllowExponent and Number flags.
styles = NumberStyles.AllowExponent | NumberStyles.Number;
ShowNumericValue(value, styles);
// Parse a currency value with leading and trailing white space, and
// white space after the U.S. currency symbol.
value = " $ 6,164.3299 ";
styles = NumberStyles.Number | NumberStyles.AllowCurrencySymbol;
ShowNumericValue(value, styles);
// Parse negative value with thousands separator and decimal.
value = "(4,320.64)";
styles = NumberStyles.AllowParentheses | NumberStyles.AllowTrailingSign |
NumberStyles.Float;
ShowNumericValue(value, styles);
styles = NumberStyles.AllowParentheses | NumberStyles.AllowTrailingSign |
NumberStyles.Float | NumberStyles.AllowThousands;
ShowNumericValue(value, styles);
}
private static void ShowNumericValue(string value, NumberStyles styles)
{
Single number;
try
{
number = Single.Parse(value, styles);
Console.WriteLine("Converted '{0}' using {1} to {2}.",
value, styles.ToString(), number);
}
catch (FormatException)
{
Console.WriteLine("Unable to parse '{0}' with styles {1}.",
value, styles.ToString());
}
Console.WriteLine();
}
}
// The example displays the following output to the console:
// Unable to parse '-1.063E-02' with styles AllowExponent.
//
// Converted '-1.063E-02' using AllowTrailingSign, AllowThousands, Float to -0.01063.
//
// Converted ' $ 6,164.3299 ' using Number, AllowCurrencySymbol to 6164.3299.
//
// Unable to parse '(4,320.64)' with styles AllowTrailingSign, AllowParentheses, Float.
//
// Converted '(4,320.64)' using AllowTrailingSign, AllowParentheses, AllowThousands, Float to -4320.64.
open System
open System.Globalization
open System.Threading
let showNumericValue value (styles: NumberStyles) =
try
let number = Single.Parse(value, styles)
printfn $"Converted '{value}' using {styles} to {number}."
with :? FormatException ->
printfn $"Unable to parse '{value}' with styles {styles}."
printfn ""
[<EntryPoint>]
let main _ =
// Set current thread culture to en-US.
Thread.CurrentThread.CurrentCulture <- CultureInfo.CreateSpecificCulture "en-US"
// Parse a string in exponential notation with only the AllowExponent flag.
let value = "-1.063E-02"
let styles = NumberStyles.AllowExponent
showNumericValue value styles
// Parse a string in exponential notation
// with the AllowExponent and Number flags.
let styles = NumberStyles.AllowExponent ||| NumberStyles.Number
showNumericValue value styles
// Parse a currency value with leading and trailing white space, and
// white space after the U.S. currency symbol.
let value = " $ 6,164.3299 "
let styles = NumberStyles.Number ||| NumberStyles.AllowCurrencySymbol
showNumericValue value styles
// Parse negative value with thousands separator and decimal.
let value = "(4,320.64)"
let styles = NumberStyles.AllowParentheses ||| NumberStyles.AllowTrailingSign ||| NumberStyles.Float
showNumericValue value styles
let styles = NumberStyles.AllowParentheses ||| NumberStyles.AllowTrailingSign ||| NumberStyles.Float ||| NumberStyles.AllowThousands
showNumericValue value styles
0
// The example displays the following output to the console:
// Unable to parse '-1.063E-02' with styles AllowExponent.
//
// Converted '-1.063E-02' using AllowTrailingSign, AllowThousands, Float to -0.01063.
//
// Converted ' $ 6,164.3299 ' using Number, AllowCurrencySymbol to 6164.3299.
//
// Unable to parse '(4,320.64)' with styles AllowTrailingSign, AllowParentheses, Float.
//
// Converted '(4,320.64)' using AllowTrailingSign, AllowParentheses, AllowThousands, Float to -4320.64.
Imports System.Globalization
Imports System.Threading
Module ParseStrings
Public Sub Main()
' Set current thread culture to en-US.
Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("en-US")
Dim value As String
Dim styles As NumberStyles
' Parse a string in exponential notation with only the AllowExponent flag.
value = "-1.063E-02"
styles = NumberStyles.AllowExponent
ShowNumericValue(value, styles)
' Parse a string in exponential notation
' with the AllowExponent and Number flags.
styles = NumberStyles.AllowExponent Or NumberStyles.Number
ShowNumericValue(value, styles)
' Parse a currency value with leading and trailing white space, and
' white space after the U.S. currency symbol.
value = " $ 6,164.3299 "
styles = NumberStyles.Number Or NumberStyles.AllowCurrencySymbol
ShowNumericValue(value, styles)
' Parse negative value with thousands separator and decimal.
value = "(4,320.64)"
styles = NumberStyles.AllowParentheses Or NumberStyles.AllowTrailingSign _
Or NumberStyles.Float
ShowNumericValue(value, styles)
styles = NumberStyles.AllowParentheses Or NumberStyles.AllowTrailingSign _
Or NumberStyles.Float Or NumberStyles.AllowThousands
ShowNumericValue(value, styles)
End Sub
Private Sub ShowNumericValue(value As String, styles As NumberStyles)
Dim number As Single
Try
number = Single.Parse(value, styles)
Console.WriteLine("Converted '{0}' using {1} to {2}.", _
value, styles.ToString(), number)
Catch e As FormatException
Console.WriteLine("Unable to parse '{0}' with styles {1}.", _
value, styles.ToString())
End Try
Console.WriteLine()
End Sub
End Module
' The example displays the following output to the console:
' Unable to parse '-1.063E-02' with styles AllowExponent.
'
' Converted '-1.063E-02' using AllowTrailingSign, AllowThousands, Float to -0.01063.
'
' Converted ' $ 6,164.3299 ' using Number, AllowCurrencySymbol to 6164.3299.
'
' Unable to parse '(4,320.64)' with styles AllowTrailingSign, AllowParentheses, Float.
'
' Converted '(4,320.64)' using AllowTrailingSign, AllowParentheses, AllowThousands, Float to -4320.64.
Uwagi
W programie .NET Core 3.0 i nowszych wartości, które są zbyt duże do reprezentowania, są zaokrąglane do PositiveInfinity lub NegativeInfinity zgodnie z wymaganiami specyfikacji IEEE 754. W poprzednich wersjach, w tym .NET Framework, analizowanie wartości, która była zbyt duża, aby reprezentować wynik awarii.
Parametr style
definiuje elementy stylu (takie jak białe znaki, separatory tysięcy i symbole waluty), które są dozwolone w parametrze s
operacji analizowania, aby operacja analizy zakończyła się powodzeniem. Musi być kombinacją flag bitowych z wyliczenia NumberStyles . Następujące NumberStyles elementy członkowskie nie są obsługiwane:
Parametr s
może zawierać bieżącą kulturę PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol. W zależności od wartości parametru style
może on również mieć postać:
[ws] [$][znak][cyfry całkowite[,]]cyfry całkowite[.[cyfry ułamkowe]] [E[znak]cyfry wykładnicze] [ws]
Elementy w nawiasach kwadratowych ([ i ]) są opcjonalne. W tabeli poniżej opisano każdy element.
Ws Seria znaków białych znaków. Biały odstęp może pojawić się na początku s
, jeśli style
zawiera flagę NumberStyles.AllowLeadingWhite i może pojawić się na końcu s
, jeśli style
zawiera flagę NumberStyles.AllowTrailingWhite .
$ Symbol waluty specyficznej dla kultury. Jego pozycja w ciągu jest definiowana przez NumberFormatInfo.CurrencyNegativePattern właściwości i NumberFormatInfo.CurrencyPositivePattern bieżącej kultury. Symbol waluty bieżącej kultury może być wyświetlany, s
jeśli style
zawiera flagę NumberStyles.AllowCurrencySymbol .
Znak Symbol znaku ujemnego (-) lub symbol znaku dodatniego (+). Znak może pojawić się na początku s
, jeśli style
zawiera flagę NumberStyles.AllowLeadingSign , i może pojawić się na końcu s
, jeśli style
zawiera flagę NumberStyles.AllowTrailingSign . Nawiasy mogą służyć s
do wskazywania wartości ujemnej, jeśli style
zawiera flagę NumberStyles.AllowParentheses .
cyfry całkowite Seria cyfr od 0 do 9 określająca integralną część liczby. Element całkowitocyfrowy może być nieobecny , jeśli ciąg zawiera element ułamkowe cyfry .
, separator grupy specyficzny dla kultury. Symbol separatora grup bieżącej kultury może pojawić się, s
jeśli style
zawiera flagę NumberStyles.AllowThousands
.
Symbol dziesiętny specyficzny dla kultury. Symbol punktu dziesiętnego bieżącej kultury może pojawić się, s
jeśli style
zawiera flagę NumberStyles.AllowDecimalPoint .
cyfry ułamkowe Seria cyfr od 0 do 9 określająca część ułamkową liczby. Cyfry ułamkowe mogą pojawiać się, s
jeśli style
zawiera flagę NumberStyles.AllowDecimalPoint .
E Znak "e" lub "E", który wskazuje, że wartość jest reprezentowana w notacji wykładniczej (naukowej). Parametr value
może reprezentować liczbę w notacji wykładniczej, jeśli style
zawiera flagę NumberStyles.AllowExponent .
cyfry wykładnicze Seria cyfr od 0 do 9 określająca wykładnik.
Uwaga
Wszystkie znaki NUL zakończenia (U+0000) w s
obiekcie są ignorowane przez operację analizowania, niezależnie od wartości argumentu style
.
Ciąg z tylko cyframi (odpowiadający NumberStyles.None stylowi) zawsze analizuje się pomyślnie, jeśli znajduje się w zakresie Single typu. Pozostałe System.Globalization.NumberStyles elementy członkowskie kontrolują, które mogą być obecne, ale nie muszą być obecne, w ciągu wejściowym. W poniższej tabeli przedstawiono, jak poszczególne NumberStyles flagi wpływają na elementy, które mogą być obecne w programie s
.
Wartość wyliczenia NumberStyles | Elementy dozwolone oprócz s cyfr |
---|---|
None | Tylko element całkowitocyfrowy . |
AllowDecimalPoint | Elementy separatora dziesiętnego (.) i cyfr ułamkowych . |
AllowExponent | Znak „e” lub znak „E”, co oznacza zapis wykładniczy. Ta flaga sama obsługuje wartości w cyfrachE formularza; Dodatkowe flagi są potrzebne do pomyślnego analizowania ciągów z takimi elementami jak dodatnie lub ujemne znaki i symbole punktów dziesiętnych. |
AllowLeadingWhite | Element ws na początku elementu s . |
AllowTrailingWhite | Element ws na końcu elementu s . |
AllowLeadingSign | Element znaku na początku elementu s . |
AllowTrailingSign | Element znaku na końcu elementu s . |
AllowParentheses | Element znaku w postaci nawiasów otaczających wartość liczbową. |
AllowThousands | Element separatora tysięcznego (,). |
AllowCurrencySymbol | Element określający walutę ($). |
Currency | Wszystkie elementy.
s Nie można jednak reprezentować liczby szesnastkowej ani liczby w notacji wykładniczej. |
Float | Element ws na początku lub na końcu s znaku na początku znaku na początku s i symbolu przecinka dziesiętnego (.). Parametr s może również używać notacji wykładniczej. |
Number |
ws Elementy separatora , sign tysięcy (,) i separatora dziesiętnego (.). |
Any | Wszystkie elementy.
s Nie można jednak reprezentować liczby szesnastkowej. |
Niektóre przykłady s
to "100", "-123,456,789", "123.45e+6", "+500", "5e2", "3.1416", "600.", "-.123" i "-Infinity".
Parametr s
jest analizowany przy użyciu informacji o formatowaniu w obiekcie zainicjowanym NumberFormatInfo dla bieżącej kultury systemu. Aby określić kulturę, której informacje o formatowaniu są używane dla operacji analizy, wywołaj Parse(String, NumberStyles, IFormatProvider) przeciążenie.
Zwykle, jeśli przekazujesz Parse metodę ciąg, który jest tworzony przez wywołanie ToString metody , zwracana jest oryginalna Single wartość. Jednak ze względu na utratę precyzji wartości mogą być różne.
Jeśli s
typ danych jest poza zakresemSingle, metoda zgłasza wyjątek OverflowException w wersjach .NET Framework i .NET Core 2.2 i starszych. W programie .NET Core 3.0 i nowszych wersjach zwraca Single.NegativeInfinity wartość , jeśli s
wartość jest mniejsza niż Single.MinValue i Single.PositiveInfinity jest s
większa niż Single.MaxValue.
Jeśli separator napotkany w parametrze s
podczas operacji analizy, a odpowiednia waluta lub separatory liczbowe i separatory grup są takie same, operacja analizy zakłada, że separator jest separatorem dziesiętnym, a nie separatorem grupy. Aby uzyskać więcej informacji na temat separatorów, zobacz CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparatori NumberGroupSeparator.
Zobacz też
Dotyczy
Parse(String, IFormatProvider)
- Źródło:
- Single.cs
- Źródło:
- Single.cs
- Źródło:
- Single.cs
Konwertuje reprezentację ciągu liczby w określonym formacie specyficznym dla kultury na odpowiednik liczb zmiennoprzecinkowych o pojedynczej precyzji.
public:
static float Parse(System::String ^ s, IFormatProvider ^ provider);
public:
static float Parse(System::String ^ s, IFormatProvider ^ provider) = IParsable<float>::Parse;
public static float Parse (string s, IFormatProvider provider);
public static float Parse (string s, IFormatProvider? provider);
static member Parse : string * IFormatProvider -> single
Public Shared Function Parse (s As String, provider As IFormatProvider) As Single
Parametry
- s
- String
Ciąg zawierający liczbę, którą należy przekształcić.
- provider
- IFormatProvider
Obiekt, który dostarcza informacje o formatowaniu specyficznym dla kultury.s
Zwraca
Liczba zmiennoprzecinkowa o pojedynczej precyzji równoważna wartości liczbowej lub symbolowi określonemu w elemencie s
.
Implementuje
Wyjątki
s
to null
.
s
nie reprezentuje liczby w prawidłowym formacie.
.NET Framework i .NET Core 2.2 i starsze wersje: s
reprezentuje tylko liczbę mniejszą niż Single.MinValue lub większą niż Single.MaxValue.
Przykłady
W poniższym przykładzie występuje program obsługi zdarzeń kliknięcia przycisku w formularzu sieci Web. Używa tablicy zwracanej przez HttpRequest.UserLanguages właściwość , aby określić ustawienia regionalne użytkownika. Następnie tworzy wystąpienie CultureInfo obiektu odpowiadającego tym ustawieniam regionalnym. Obiekt NumberFormatInfo należący do tego CultureInfo obiektu jest następnie przekazywany do Parse(String, IFormatProvider) metody w celu przekonwertowania danych wejściowych użytkownika na Single wartość.
protected void OkToSingle_Click(object sender, EventArgs e)
{
string locale;
float number;
CultureInfo culture;
// Return if string is empty
if (String.IsNullOrEmpty(this.inputNumber.Text))
return;
// Get locale of web request to determine possible format of number
if (Request.UserLanguages.Length == 0)
return;
locale = Request.UserLanguages[0];
if (String.IsNullOrEmpty(locale))
return;
// Instantiate CultureInfo object for the user's locale
culture = new CultureInfo(locale);
// Convert user input from a string to a number
try
{
number = Single.Parse(this.inputNumber.Text, culture.NumberFormat);
}
catch (FormatException)
{
return;
}
catch (Exception)
{
return;
}
// Output number to label on web form
this.outputNumber.Text = "Number is " + number.ToString();
}
Protected Sub OkToSingle_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles OkToSingle.Click
Dim locale As String
Dim culture As CultureInfo
Dim number As Single
' Return if string is empty
If String.IsNullOrEmpty(Me.inputNumber.Text) Then Exit Sub
' Get locale of web request to determine possible format of number
If Request.UserLanguages.Length = 0 Then Exit Sub
locale = Request.UserLanguages(0)
If String.IsNullOrEmpty(locale) Then Exit Sub
' Instantiate CultureInfo object for the user's locale
culture = New CultureInfo(locale)
' Convert user input from a string to a number
Try
number = Single.Parse(Me.inputNumber.Text, culture.NumberFormat)
Catch ex As FormatException
Exit Sub
Catch ex As OverflowException
Exit Sub
End Try
' Output number to label on web form
Me.outputNumber.Text = "Number is " & number.ToString()
End Sub
Uwagi
W programie .NET Core 3.0 lub nowszym wartości, które są zbyt duże do reprezentowania, są zaokrąglane do PositiveInfinity lub NegativeInfinity zgodnie ze specyfikacją IEEE 754. W poprzednich wersjach, w tym .NET Framework, analizowanie wartości, która była zbyt duża, aby reprezentować, spowodowało niepowodzenie.
To przeciążenie jest zwykle używane do konwertowania tekstu, który można sformatować na różne sposoby na Single wartość. Może na przykład służyć do skonwertowania tekstu wprowadzanego przez użytkownika w polu tekstowym HTML na wartość liczbową.
Parametr s
jest interpretowany przy użyciu kombinacji NumberStyles.Float flag i NumberStyles.AllowThousands . Parametr s
może zawierać NumberFormatInfo.PositiveInfinitySymbol, NumberFormatInfo.NegativeInfinitySymbollub NumberFormatInfo.NaNSymbol dla kultury określonej przez provider
, lub może zawierać ciąg formularza:
[ws] [podpis] cyfry całkowite[.[cyfry ułamkowe]] [E[znak]cyfry wykładnicze] [ws]
Elementy opcjonalne są obramowane nawiasami kwadratowymi ([ i ]). Elementy, które zawierają „cyfry”, składają się z serii cyfr od 0 do 9.
Element | Opis |
---|---|
Ws | Ciąg znaków spacji. |
sign | Symbol znaku minus (-) lub znaku dodatniego (+). |
cyfry-całkowite | Ciąg cyfr od 0 do 9, które określają jej część całkowitą. Uruchomienia cyfr całkowitych można podzielić na partycje za pomocą symbolu separatora grup. Na przykład w niektórych kulturach przecinek (,) oddziela grupy wartości tysięcznych. Element całkowitocyfrowy może być nieobecny , jeśli ciąg zawiera element ułamkowe cyfry . |
. | Symbol dziesiętny specyficzny dla kultury. |
cyfry-ułamkowe | Ciąg cyfr od 0 do 9, które określają część ułamkową liczby. |
E | Znak „e” lub „E”, który wskazuje, że wartość jest reprezentowana w zapisie wykładniczym (naukowym). |
cyfry-wykładnicze | Ciąg cyfr od 0 do 9, które określają wykładnik potęgi. |
Aby uzyskać więcej informacji na temat formatów liczbowych, zobacz temat Typy formatowania .
Parametr provider
jest implementacją IFormatProvider , której GetFormat metoda zwraca NumberFormatInfo obiekt, który dostarcza informacje o formatowaniu specyficznym dla kultury. Po wywołaniu Parse(String, IFormatProvider) metody wywołuje provider
metodę parametru GetFormat i przekazuje go Type do obiektu reprezentującego NumberFormatInfo typ. Następnie GetFormat metoda zwraca NumberFormatInfo obiekt, który dostarcza informacje o formacie parametru s
. Istnieją trzy sposoby użycia parametru provider
w celu dostarczenia niestandardowych informacji o formatowaniu do operacji analizy:
Można przekazać obiekt reprezentujący kulturę CultureInfo dostarczającą informacje o formatowaniu. Metoda GetFormat zwraca NumberFormatInfo obiekt, który dostarcza informacje o formatowaniu liczbowym dla tej kultury.
Można przekazać rzeczywisty NumberFormatInfo obiekt, który udostępnia informacje o formatowaniu liczbowym. (Jego implementacja GetFormat samego zwraca się).
Można przekazać obiekt niestandardowy, który implementuje IFormatProviderelement . Metoda GetFormat tworzy wystąpienie i zwraca NumberFormatInfo obiekt, który dostarcza informacje o formatowaniu.
Jeśli provider
nie null
można uzyskać wartości lub nie NumberFormatInfo można uzyskać informacji o formatowaniu dla bieżącej kultury systemu.
Jeśli s
typ danych jest poza zakresemSingle, metoda zgłasza wyjątek OverflowException w wersjach .NET Framework i .NET Core 2.2 i starszych. W programie .NET Core 3.0 i nowszych wersjach zwraca Single.NegativeInfinity wartość , jeśli s
wartość jest mniejsza niż Single.MinValue i Single.PositiveInfinity jest s
większa niż Single.MaxValue.
Jeśli separator napotkany w parametrze s
podczas operacji analizy, a odpowiednia waluta lub separatory liczbowe i separatory grup są takie same, operacja analizy zakłada, że separator jest separatorem dziesiętnym, a nie separatorem grupy. Aby uzyskać więcej informacji na temat separatorów, zobacz CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparatori NumberGroupSeparator.
Niektóre przykłady s
to "100", "-123,456,789", "123.45e+6", "+500", "5e2", "3.1416", "600.", "-.123" i "-Infinity".
Zobacz też
Dotyczy
Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)
- Źródło:
- Single.cs
- Źródło:
- Single.cs
Analizuje zakres znaków UTF-8 w wartości.
public static float Parse (ReadOnlySpan<byte> utf8Text, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.AllowThousands | System.Globalization.NumberStyles.Float, IFormatProvider? provider = default);
static member Parse : ReadOnlySpan<byte> * System.Globalization.NumberStyles * IFormatProvider -> single
Public Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte), Optional style As NumberStyles = System.Globalization.NumberStyles.AllowThousands | System.Globalization.NumberStyles.Float, Optional provider As IFormatProvider = Nothing) As Single
Parametry
- utf8Text
- ReadOnlySpan<Byte>
Zakres znaków UTF-8 do analizy.
- style
- NumberStyles
Bitowa kombinacja stylów liczbowych, które mogą być obecne w .utf8Text
- provider
- IFormatProvider
Obiekt, który udostępnia informacje o formatowaniu specyficznym dla kultury.utf8Text
Zwraca
Wynik analizy utf8Text
.
Implementuje
Dotyczy
Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)
- Źródło:
- Single.cs
- Źródło:
- Single.cs
- Źródło:
- Single.cs
Konwertuje zakres znaków, który zawiera reprezentację ciągu liczby w określonym stylu i formacie specyficznym dla kultury na równoważnik liczby zmiennoprzecinkowe o pojedynczej precyzji.
public static float Parse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.AllowThousands | System.Globalization.NumberStyles.Float, IFormatProvider? provider = default);
public static float Parse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.AllowThousands | System.Globalization.NumberStyles.Float, IFormatProvider provider = default);
static member Parse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider -> single
Public Shared Function Parse (s As ReadOnlySpan(Of Char), Optional style As NumberStyles = System.Globalization.NumberStyles.AllowThousands | System.Globalization.NumberStyles.Float, Optional provider As IFormatProvider = Nothing) As Single
Parametry
- s
- ReadOnlySpan<Char>
Zakres znaków zawierający liczbę, która ma być konwertowana.
- style
- NumberStyles
Bitowa kombinacja wartości wyliczenia, które wskazują elementy stylu, które mogą być obecne w .s
Typowa wartość do określenia jest Float połączona z elementem AllowThousands.
- provider
- IFormatProvider
Obiekt, który dostarcza informacje o formatowaniu specyficznym dla kultury.s
Zwraca
Liczba zmiennoprzecinkowa o pojedynczej precyzji, która jest równoważna wartości liczbowej lub symbolowi określonemu w elemencie s
.
Implementuje
Wyjątki
s
nie reprezentuje wartości liczbowej.
Uwagi
W programie .NET Core 3.0 lub nowszym wartości, które są zbyt duże do reprezentowania, są zaokrąglane do PositiveInfinity lub NegativeInfinity zgodnie ze specyfikacją IEEE 754. W poprzednich wersjach, w tym .NET Framework, analizowanie wartości, która była zbyt duża, aby reprezentować, spowodowało niepowodzenie.
Jeśli s
jest poza zakresem Single typu danych, metoda zwraca Single.NegativeInfinity wartość , jeśli s
wartość jest mniejsza niż Single.MinValue i Single.PositiveInfinity jeśli s
jest większa niż Single.MaxValue.
Dotyczy
Parse(String, NumberStyles, IFormatProvider)
- Źródło:
- Single.cs
- Źródło:
- Single.cs
- Źródło:
- Single.cs
Konwertuje reprezentację ciągu liczby w określonym stylu i formacie specyficznym dla kultury na równoważność liczb zmiennoprzecinkowych o pojedynczej precyzji.
public:
static float Parse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider);
public:
static float Parse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider) = System::Numerics::INumberBase<float>::Parse;
public static float Parse (string s, System.Globalization.NumberStyles style, IFormatProvider provider);
public static float Parse (string s, System.Globalization.NumberStyles style, IFormatProvider? provider);
static member Parse : string * System.Globalization.NumberStyles * IFormatProvider -> single
Public Shared Function Parse (s As String, style As NumberStyles, provider As IFormatProvider) As Single
Parametry
- s
- String
Ciąg zawierający liczbę, którą należy przekształcić.
- style
- NumberStyles
Bitowa kombinacja wartości wyliczenia wskazująca elementy stylu, które mogą być obecne w obiekcie s
. Typowa wartość do określenia jest Float połączona z elementem AllowThousands.
- provider
- IFormatProvider
Obiekt, który dostarcza informacje o formatowaniu specyficznym dla kultury.s
Zwraca
Liczba zmiennoprzecinkowa o pojedynczej precyzji równoważna wartości liczbowej lub symbolowi określonemu w elemencie s
.
Implementuje
Wyjątki
s
to null
.
s
nie reprezentuje wartości liczbowej.
.NET Framework i .NET Core 2.2 i starsze wersje tylko: s
reprezentuje liczbę mniejszą niż Single.MinValue lub większą niż Single.MaxValue.
Przykłady
W poniższym przykładzie kodu użyto Parse(String, NumberStyles, IFormatProvider) metody , aby przeanalizować reprezentacje ciągów Single wartości. Każdy ciąg w tablicy jest analizowany przy użyciu konwencji formatowania en-US, nl-NL i kultury niestandardowej. Kultura niestandardowa definiuje symbol separatora grup jako podkreślenie ("_") i rozmiar grupy jako dwa.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
// Define an array of string values.
string[] values = { " 987.654E-2", " 987,654E-2", "(98765,43210)",
"9,876,543.210", "9.876.543,210", "98_76_54_32,19" };
// Create a custom culture based on the invariant culture.
CultureInfo ci = new CultureInfo("");
ci.NumberFormat.NumberGroupSizes = new int[] { 2 };
ci.NumberFormat.NumberGroupSeparator = "_";
// Define an array of format providers.
CultureInfo[] providers = { new CultureInfo("en-US"),
new CultureInfo("nl-NL"), ci };
// Define an array of styles.
NumberStyles[] styles = { NumberStyles.Currency, NumberStyles.Float };
// Iterate the array of format providers.
foreach (CultureInfo provider in providers)
{
Console.WriteLine("Parsing using the {0} culture:",
provider.Name == String.Empty ? "Invariant" : provider.Name);
// Parse each element in the array of string values.
foreach (string value in values)
{
foreach (NumberStyles style in styles)
{
try {
float number = Single.Parse(value, style, provider);
Console.WriteLine(" {0} ({1}) -> {2}",
value, style, number);
}
catch (FormatException) {
Console.WriteLine(" '{0}' is invalid using {1}.", value, style);
}
catch (OverflowException) {
Console.WriteLine(" '{0}' is out of the range of a Single.", value);
}
}
}
Console.WriteLine();
}
}
}
// The example displays the following output:
// Parsing using the en-US culture:
// ' 987.654E-2' is invalid using Currency.
// 987.654E-2 (Float) -> 9.87654
// ' 987,654E-2' is invalid using Currency.
// ' 987,654E-2' is invalid using Float.
// (98765,43210) (Currency) -> -9.876543E+09
// '(98765,43210)' is invalid using Float.
// 9,876,543.210 (Currency) -> 9876543
// '9,876,543.210' is invalid using Float.
// '9.876.543,210' is invalid using Currency.
// '9.876.543,210' is invalid using Float.
// '98_76_54_32,19' is invalid using Currency.
// '98_76_54_32,19' is invalid using Float.
//
// Parsing using the nl-NL culture:
// ' 987.654E-2' is invalid using Currency.
// ' 987.654E-2' is invalid using Float.
// ' 987,654E-2' is invalid using Currency.
// 987,654E-2 (Float) -> 9.87654
// (98765,43210) (Currency) -> -98765.43
// '(98765,43210)' is invalid using Float.
// '9,876,543.210' is invalid using Currency.
// '9,876,543.210' is invalid using Float.
// 9.876.543,210 (Currency) -> 9876543
// '9.876.543,210' is invalid using Float.
// '98_76_54_32,19' is invalid using Currency.
// '98_76_54_32,19' is invalid using Float.
//
// Parsing using the Invariant culture:
// ' 987.654E-2' is invalid using Currency.
// 987.654E-2 (Float) -> 9.87654
// ' 987,654E-2' is invalid using Currency.
// ' 987,654E-2' is invalid using Float.
// (98765,43210) (Currency) -> -9.876543E+09
// '(98765,43210)' is invalid using Float.
// 9,876,543.210 (Currency) -> 9876543
// '9,876,543.210' is invalid using Float.
// '9.876.543,210' is invalid using Currency.
// '9.876.543,210' is invalid using Float.
// 98_76_54_32,19 (Currency) -> 9.876543E+09
// '98_76_54_32,19' is invalid using Float.
open System
open System.Globalization
// Define a list of string values.
let values =
[ " 987.654E-2"; " 987,654E-2"; "(98765,43210)"
"9,876,543.210"; "9.876.543,210"; "98_76_54_32,19" ]
// Create a custom culture based on the invariant culture.
let ci = CultureInfo ""
ci.NumberFormat.NumberGroupSizes <- [| 2 |]
ci.NumberFormat.NumberGroupSeparator <- "_"
// Define a list of format providers.
let providers =
[ CultureInfo "en-US"
CultureInfo "nl-NL"
ci ]
// Define a list of styles.
let styles = [ NumberStyles.Currency; NumberStyles.Float ]
// Iterate the list of format providers.
for provider in providers do
printfn $"""Parsing using the {if provider.Name = String.Empty then "Invariant" else provider.Name} culture:"""
// Parse each element in the array of string values.
for value in values do
for style in styles do
try
let number = Single.Parse(value, style, provider)
printfn $" {value} ({style}) -> {number}"
with
| :? FormatException ->
printfn $" '{value}' is invalid using {style}."
| :? OverflowException ->
printfn $" '{value}' is out of the range of a Single."
printfn ""
// The example displays the following output:
// Parsing using the en-US culture:
// ' 987.654E-2' is invalid using Currency.
// 987.654E-2 (Float) -> 9.87654
// ' 987,654E-2' is invalid using Currency.
// ' 987,654E-2' is invalid using Float.
// (98765,43210) (Currency) -> -9.876543E+09
// '(98765,43210)' is invalid using Float.
// 9,876,543.210 (Currency) -> 9876543
// '9,876,543.210' is invalid using Float.
// '9.876.543,210' is invalid using Currency.
// '9.876.543,210' is invalid using Float.
// '98_76_54_32,19' is invalid using Currency.
// '98_76_54_32,19' is invalid using Float.
//
// Parsing using the nl-NL culture:
// ' 987.654E-2' is invalid using Currency.
// ' 987.654E-2' is invalid using Float.
// ' 987,654E-2' is invalid using Currency.
// 987,654E-2 (Float) -> 9.87654
// (98765,43210) (Currency) -> -98765.43
// '(98765,43210)' is invalid using Float.
// '9,876,543.210' is invalid using Currency.
// '9,876,543.210' is invalid using Float.
// 9.876.543,210 (Currency) -> 9876543
// '9.876.543,210' is invalid using Float.
// '98_76_54_32,19' is invalid using Currency.
// '98_76_54_32,19' is invalid using Float.
//
// Parsing using the Invariant culture:
// ' 987.654E-2' is invalid using Currency.
// 987.654E-2 (Float) -> 9.87654
// ' 987,654E-2' is invalid using Currency.
// ' 987,654E-2' is invalid using Float.
// (98765,43210) (Currency) -> -9.876543E+09
// '(98765,43210)' is invalid using Float.
// 9,876,543.210 (Currency) -> 9876543
// '9,876,543.210' is invalid using Float.
// '9.876.543,210' is invalid using Currency.
// '9.876.543,210' is invalid using Float.
// 98_76_54_32,19 (Currency) -> 9.876543E+09
// '98_76_54_32,19' is invalid using Float.
Imports System.Globalization
Module Example
Public Sub Main()
' Define an array of string values.
Dim values() As String = { " 987.654E-2", " 987,654E-2", _
"(98765,43210)", "9,876,543.210", _
"9.876.543,210", "98_76_54_32,19" }
' Create a custom culture based on the invariant culture.
Dim ci As New CultureInfo("")
ci.NumberFormat.NumberGroupSizes = New Integer() { 2 }
ci.NumberFormat.NumberGroupSeparator = "_"
' Define an array of format providers.
Dim providers() As CultureInfo = { New CultureInfo("en-US"), _
New CultureInfo("nl-NL"), ci }
' Define an array of styles.
Dim styles() As NumberStyles = { NumberStyles.Currency, NumberStyles.Float }
' Iterate the array of format providers.
For Each provider As CultureInfo In providers
Console.WriteLine("Parsing using the {0} culture:", _
If(provider.Name = String.Empty, "Invariant", provider.Name))
' Parse each element in the array of string values.
For Each value As String In values
For Each style As NumberStyles In styles
Try
Dim number As Single = Single.Parse(value, style, provider)
Console.WriteLine(" {0} ({1}) -> {2}", _
value, style, number)
Catch e As FormatException
Console.WriteLine(" '{0}' is invalid using {1}.", value, style)
Catch e As OverflowException
Console.WriteLine(" '{0}' is out of the range of a Single.", value)
End Try
Next
Next
Console.WriteLine()
Next
End Sub
End Module
' The example displays the following output:
' Parsing using the en-US culture:
' ' 987.654E-2' is invalid using Currency.
' 987.654E-2 (Float) -> 9.87654
' ' 987,654E-2' is invalid using Currency.
' ' 987,654E-2' is invalid using Float.
' (98765,43210) (Currency) -> -9.876543E+09
' '(98765,43210)' is invalid using Float.
' 9,876,543.210 (Currency) -> 9876543
' '9,876,543.210' is invalid using Float.
' '9.876.543,210' is invalid using Currency.
' '9.876.543,210' is invalid using Float.
' '98_76_54_32,19' is invalid using Currency.
' '98_76_54_32,19' is invalid using Float.
'
' Parsing using the nl-NL culture:
' ' 987.654E-2' is invalid using Currency.
' ' 987.654E-2' is invalid using Float.
' ' 987,654E-2' is invalid using Currency.
' 987,654E-2 (Float) -> 9.87654
' (98765,43210) (Currency) -> -98765.43
' '(98765,43210)' is invalid using Float.
' '9,876,543.210' is invalid using Currency.
' '9,876,543.210' is invalid using Float.
' 9.876.543,210 (Currency) -> 9876543
' '9.876.543,210' is invalid using Float.
' '98_76_54_32,19' is invalid using Currency.
' '98_76_54_32,19' is invalid using Float.
'
' Parsing using the Invariant culture:
' ' 987.654E-2' is invalid using Currency.
' 987.654E-2 (Float) -> 9.87654
' ' 987,654E-2' is invalid using Currency.
' ' 987,654E-2' is invalid using Float.
' (98765,43210) (Currency) -> -9.876543E+09
' '(98765,43210)' is invalid using Float.
' 9,876,543.210 (Currency) -> 9876543
' '9,876,543.210' is invalid using Float.
' '9.876.543,210' is invalid using Currency.
' '9.876.543,210' is invalid using Float.
' 98_76_54_32,19 (Currency) -> 9.876543E+09
' '98_76_54_32,19' is invalid using Float.
Uwagi
W programie .NET Core 3.0 lub nowszym wartości, które są zbyt duże do reprezentowania, są zaokrąglane do PositiveInfinity lub NegativeInfinity zgodnie ze specyfikacją IEEE 754. W poprzednich wersjach, w tym .NET Framework, analizowanie wartości, która była zbyt duża, aby reprezentować, spowodowało niepowodzenie.
Parametr style
definiuje elementy stylu (takie jak białe znaki, separatory tysięcy i symbole waluty), które są dozwolone w parametrze s
operacji analizowania, aby operacja analizy powiodła się. Musi to być kombinacja flag bitowych z NumberStyles wyliczenia. Następujące NumberStyles elementy członkowskie nie są obsługiwane:
Parametr s
może zawierać NumberFormatInfo.PositiveInfinitySymbolwartość , NumberFormatInfo.NegativeInfinitySymbollub NumberFormatInfo.NaNSymbol dla kultury określonej przez provider
. W zależności od wartości parametru style
może ona również mieć postać:
[ws] [$] [znak][cyfry całkowite,]cyfry całkowite[.[ cyfry ułamkowe]] [E[znak]cyfry wykładnicze] [ws]
Elementy w nawiasach kwadratowych ([ i ]) są opcjonalne. W tabeli poniżej opisano każdy element.
Element | Opis |
---|---|
Ws | Ciąg znaków spacji. Białe znaki mogą pojawić się na początku s , jeśli style zawiera flagę NumberStyles.AllowLeadingWhite , i może pojawić się na końcu s , jeśli style zawiera flagę NumberStyles.AllowTrailingWhite . |
$ | Symbol waluty specyficzny dla kultury. Jego pozycja w ciągu jest definiowana przez NumberFormatInfo.CurrencyNegativePattern właściwości i NumberFormatInfo.CurrencyPositivePattern bieżącej kultury. Symbol waluty bieżącej kultury może pojawić się, s jeśli style zawiera flagę NumberStyles.AllowCurrencySymbol . |
sign | Symbol znaku minus (-) lub znaku dodatniego (+). Znak może pojawić się na początku s , jeśli style zawiera flagę NumberStyles.AllowLeadingSign , i może pojawić się na końcu s , jeśli style zawiera flagę NumberStyles.AllowTrailingSign . Nawiasy mogą służyć s do wskazywania wartości ujemnej, jeśli style zawiera flagę NumberStyles.AllowParentheses . |
cyfry-całkowite | Ciąg cyfr od 0 do 9, które określają jej część całkowitą. Element całkowitocyfrowy może być nieobecny , jeśli ciąg zawiera element ułamkowe cyfry . |
, | Separator grupy specyficzny dla kultury. Symbol separatora grup bieżącej kultury może pojawić się, s jeśli style zawiera flagę NumberStyles.AllowThousands |
. | Symbol dziesiętny specyficzny dla kultury. Symbol punktu dziesiętnego bieżącej kultury może pojawić się, s jeśli style zawiera flagę NumberStyles.AllowDecimalPoint . |
cyfry-ułamkowe | Ciąg cyfr od 0 do 9, które określają część ułamkową liczby. Cyfry ułamkowe mogą pojawiać się, s jeśli style zawiera flagę NumberStyles.AllowDecimalPoint . |
E | Znak „e” lub „E”, który wskazuje, że wartość jest reprezentowana w zapisie wykładniczym (naukowym). Parametr s może reprezentować liczbę w notacji wykładniczej, jeśli style zawiera flagę NumberStyles.AllowExponent . |
cyfry-wykładnicze | Ciąg cyfr od 0 do 9, które określają wykładnik potęgi. |
Uwaga
Wszystkie znaki NUL zakończenia (U+0000) w s
obiekcie są ignorowane przez operację analizowania, niezależnie od wartości argumentu style
.
Ciąg z tylko cyframi (odpowiadający NumberStyles.None stylowi) zawsze analizuje się pomyślnie, jeśli znajduje się w zakresie Single typu. Pozostałe System.Globalization.NumberStyles elementy członkowskie kontrolują, które mogą być obecne, ale nie muszą być obecne, w ciągu wejściowym. W poniższej tabeli przedstawiono, jak poszczególne NumberStyles flagi wpływają na elementy, które mogą być obecne w programie s
.
Wartość wyliczenia NumberStyles | Elementy dozwolone oprócz s cyfr |
---|---|
None | Tylko element całkowitocyfrowy . |
AllowDecimalPoint | Elementy separatora dziesiętnego (.) i cyfr ułamkowych . |
AllowExponent | Znak „e” lub znak „E”, co oznacza zapis wykładniczy. Ta flaga sama obsługuje wartości w cyfrachE formularza; Dodatkowe flagi są potrzebne do pomyślnego analizowania ciągów z takimi elementami jak dodatnie lub ujemne znaki i symbole punktów dziesiętnych. |
AllowLeadingWhite | Element ws na początku elementu s . |
AllowTrailingWhite | Element ws na końcu elementu s . |
AllowLeadingSign | Element znaku na początku elementu s . |
AllowTrailingSign | Element znaku na końcu elementu s . |
AllowParentheses | Element znaku w postaci nawiasów otaczających wartość liczbową. |
AllowThousands | Element separatora tysięcznego (,). |
AllowCurrencySymbol | Element określający walutę ($). |
Currency | Wszystkie elementy.
s Nie można jednak reprezentować liczby szesnastkowej ani liczby w notacji wykładniczej. |
Float | Element ws na początku lub na końcu s znaku na początku znaku na początku s i symbolu przecinka dziesiętnego (.). Parametr s może również używać notacji wykładniczej. |
Number |
ws Elementy separatora , sign tysięcy (,) i separatora dziesiętnego (.). |
Any | Wszystkie elementy.
s Nie można jednak reprezentować liczby szesnastkowej. |
Parametr provider
jest implementacją IFormatProvider . Metoda GetFormat zwraca NumberFormatInfo obiekt, który dostarcza informacji specyficznych dla kultury o formacie value
.
provider
Zazwyczaj może to być dowolny z następujących elementów:
CultureInfo Obiekt reprezentujący kulturę, która dostarcza informacje o formatowaniu liczbowym. Metoda GetFormat zwraca NumberFormatInfo obiekt, który udostępnia informacje o formatowaniu liczbowym.
NumberFormatInfo Obiekt, który udostępnia informacje o formatowaniu. (Jego implementacja GetFormat samego zwraca się).
Obiekt niestandardowy, który implementuje IFormatProvider metodę GetFormat i używa jej do utworzenia wystąpienia i zwrócenia NumberFormatInfo obiektu, który udostępnia informacje o formatowaniu.
Jeśli provider
parametr ma null
wartość , NumberFormatInfo używany jest obiekt bieżącej kultury.
Jeśli s
typ danych jest poza zakresemSingle, metoda zgłasza wyjątek OverflowException w wersjach .NET Framework i .NET Core 2.2 i starszych. W programie .NET Core 3.0 i nowszych wersjach zwraca Single.NegativeInfinity wartość , jeśli s
wartość jest mniejsza niż Single.MinValue i Single.PositiveInfinity jest s
większa niż Single.MaxValue.
Jeśli separator napotkany w parametrze s
podczas operacji analizy, a odpowiednia waluta lub separatory liczbowe i separatory grup są takie same, operacja analizy zakłada, że separator jest separatorem dziesiętnym, a nie separatorem grupy. Aby uzyskać więcej informacji na temat separatorów, zobacz CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparatori NumberGroupSeparator.
Zobacz też
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla