Decimal.TryParse Methode

Definition

Wandelt die angegebene Zeichenfolgendarstellung einer Zahl in ihre Decimal-Entsprechung um.Converts the string representation of a number to its Decimal equivalent. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.A return value indicates whether the conversion succeeded or failed.

Überlädt

TryParse(String, NumberStyles, IFormatProvider, Decimal)

Konvertiert die Zeichenfolgendarstellung einer Zahl unter Verwendung des angegebenen Stils und kulturspezifischer Formatierungsinformationen in die Decimal-Entsprechung.Converts the string representation of a number to its Decimal equivalent using the specified style and culture-specific format. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.A return value indicates whether the conversion succeeded or failed.

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

Konvertiert die Spannendarstellung einer Zahl unter Verwendung des angegebenen Stils und kulturspezifischer Formatierungsinformationen in die Decimal-Entsprechung.Converts the span representation of a number to its Decimal equivalent using the specified style and culture-specific format. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.A return value indicates whether the conversion succeeded or failed.

TryParse(ReadOnlySpan<Char>, Decimal)

Konvertiert die Spannendarstellung einer Zahl unter Verwendung des angegebenen Stils und kulturspezifischer Formatierungsinformationen in die Decimal-Entsprechung.Converts the span representation of a number to its Decimal equivalent using the specified style and culture-specific format. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.A return value indicates whether the conversion succeeded or failed.

TryParse(String, Decimal)

Wandelt die angegebene Zeichenfolgendarstellung einer Zahl in ihre Decimal-Entsprechung um.Converts the string representation of a number to its Decimal equivalent. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.A return value indicates whether the conversion succeeded or failed.

TryParse(String, NumberStyles, IFormatProvider, Decimal)

Konvertiert die Zeichenfolgendarstellung einer Zahl unter Verwendung des angegebenen Stils und kulturspezifischer Formatierungsinformationen in die Decimal-Entsprechung.Converts the string representation of a number to its Decimal equivalent using the specified style and culture-specific format. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.A return value indicates whether the conversion succeeded or failed.

public:
 static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::Decimal % result);
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out decimal result);
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * decimal -> bool
Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As Decimal) As Boolean

Parameter

s
String

Die Zeichenfolgendarstellung der zu konvertierenden Zahl.The string representation of the number to convert.

style
NumberStyles

Eine bitweise Kombination von Enumerationswerten, die das zulässige Format von s angibt.A bitwise combination of enumeration values that indicates the permitted format of s. Ein häufig angegebener Wert ist Number.A typical value to specify is Number.

provider
IFormatProvider

Ein Objekt, das kulturabhängige Analyseinformationen über s bereitstellt.An object that supplies culture-specific parsing information about s.

result
Decimal

Enthält bei Rückgabe dieser Methode die Decimal-Zahl, die dem numerischen Wert in s entspricht, wenn die Konvertierung erfolgreich ausgeführt wurde, oder 0 (null) bei einem Konvertierungsfehler.When this method returns, contains the Decimal number that is equivalent to the numeric value contained in s, if the conversion succeeded, or zero if the conversion failed. Bei der Konvertierung tritt ein Fehler auf, wenn der s-Parameter null oder Empty ist, nicht als Zahl in einem mit style kompatiblen Format vorliegt oder eine Zahl kleiner als MinValue oder größer als MaxValue darstellt.The conversion fails if the s parameter is null or Empty, is not a number in a format compliant with style, or represents a number less than MinValue or greater than MaxValue. Dieser Parameter wird nicht initialisiert übergeben; in result ursprünglich übergebene Werte werden ausnahmslos überschrieben.This parameter is passed uininitialized; any value originally supplied in result is overwritten.

Gibt zurück

true, wenn s erfolgreich konvertiert wurde, andernfalls false.true if s was converted successfully; otherwise, false.

Ausnahmen

style ist kein NumberStyles-Wert.style is not a NumberStyles value.

- oder --or- style ist der AllowHexSpecifier-Wert.style is the AllowHexSpecifier value.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die TryParse(String, NumberStyles, IFormatProvider, Decimal)-Methode verwendet wird, um die Zeichen folgen Darstellung einer Zahl zu analysieren, die über einen bestimmten Stil verfügt und mit den Konventionen einer bestimmten Kultur formatiert wird.The following example demonstrates the use of the TryParse(String, NumberStyles, IFormatProvider, Decimal) method to parse the string representation of a number that has a particular style and is formatted using the conventions of a particular culture.

string value;
NumberStyles style;
CultureInfo culture;
decimal number;

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

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

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

value = "1 345,978";
if (Decimal.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);
// Displays:
//       Unable to convert '1 345,978'.
Dim value As String
Dim style As NumberStyles
Dim culture As CultureInfo
Dim number As Decimal

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

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

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

value = "1 345,978"
If Decimal.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If    
' Displays:
'       Unable to convert '1 345,978'.

Hinweise

Diese Überladung unterscheidet sich von der Decimal.Parse(String, NumberStyles, IFormatProvider)-Methode, indem ein boolescher Wert zurückgegeben wird, der angibt, ob der Analyse Vorgang erfolgreich war, anstatt den analysierten numerischen Wert zurückzugeben.This overload differs from the Decimal.Parse(String, NumberStyles, IFormatProvider) method by returning a Boolean value that indicates whether the parse operation succeeded instead of returning the parsed numeric value. Es entfällt, dass die Ausnahmebehandlung verwendet werden muss, um auf eine FormatException zu testen, wenn s ungültig ist und nicht erfolgreich analysiert werden kann.It eliminates the need to use exception handling to test for a FormatException in the event that s is invalid and cannot be successfully parsed.

Der style-Parameter definiert das zulässige Format des s-Parameters, damit der Analyse Vorgang erfolgreich ausgeführt wird.The style parameter defines the allowable format of the s parameter for the parse operation to succeed. Dabei muss es sich um eine Kombination von Bitflags aus der NumberStyles Enumeration handeln.It must be a combination of bit flags from the NumberStyles enumeration. Die folgenden NumberStyles Elemente werden nicht unterstützt:The following NumberStyles members are not supported:

Abhängig vom Wert des Stils kann der s-Parameter die folgenden Elemente enthalten:Depending on the value of style, the s parameter may include the following elements:

Gefangener [$] Gebärden [Ziffern,] Ziffern [. Bruch Ziffern] [e [Zeichen] Ziffern] [WS][ws][$][sign][digits,]digits[.fractional-digits][e[sign]digits][ws]

Elemente in eckigen Klammern ([ und ]) sind optional.Elements in square brackets ([ and ]) are optional. In der folgenden Tabelle wird jedes Element beschrieben.The following table describes each element.

ElementElement BeschreibungDescription
wsws Optionaler Leerraum.Optional white space. Leerraum kann am Anfang s vorkommen, wenn style das NumberStyles.AllowLeadingWhite-Flag enthält.White space can appear at the beginning of s if style includes the NumberStyles.AllowLeadingWhite flag. Sie kann am Ende der s vorkommen, wenn style das NumberStyles.AllowTrailingWhite-Flag enthält.It can appear at the end of s if style includes the NumberStyles.AllowTrailingWhite flag.
$ Ein kulturspezifisches Währungssymbol.A culture-specific currency symbol. Die Position in der Zeichenfolge wird durch die Eigenschaften NumberFormatInfo.CurrencyNegativePattern oder NumberFormatInfo.CurrencyPositivePattern des NumberFormatInfo Objekts definiert, das von der IFormatProvider.GetFormat-Methode des provider-Parameters zurückgegeben wird.Its position in the string is defined by the NumberFormatInfo.CurrencyNegativePattern or NumberFormatInfo.CurrencyPositivePattern properties of the NumberFormatInfo object returned by the IFormatProvider.GetFormat method of the provider parameter. Das Währungssymbol kann in s angezeigt werden, wenn style das NumberStyles.AllowCurrencySymbol-Flag enthält.The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign Ein optionales Vorzeichen.An optional sign.
Zifferndigits Eine Sequenz von Ziffern zwischen 0 und 9.A sequence of digits ranging from 0 to 9.
.. Ein kulturspezifisches Dezimaltrennzeichen.A culture-specific decimal point symbol.
Bruch Ziffernfractional-digits Eine Sequenz von Ziffern zwischen 0 und 9.A sequence of digits ranging from 0 to 9.

Der style-Parameter gibt das zulässige Format des s-Parameters an und kann eine oder mehrere NumberStyles-Enumerationskonstanten sein, die mithilfe einer bitweisen OR-Operation kombiniert werden.The style parameter specifies the permitted format of the s parameter, and can be one or more NumberStyles enumerated constants combined using a bitwise OR operation. Wenn style NULL ist, wird s mithilfe des NumberStyles.Number Stils interpretiert.If style is null, s is interpreted using the NumberStyles.Number style.

Der provider-Parameter ist eine IFormatProvider Implementierung, z. b. ein NumberFormatInfo oder ein CultureInfo Objekt.The provider parameter is an IFormatProvider implementation such as a NumberFormatInfo or CultureInfo object. Der provider-Parameter liefert kulturspezifische Informationen, die beim Parsen verwendet werden.The provider parameter supplies culture-specific information used in parsing. Wenn provider gleich null ist, wird die aktuelle Threadkultur verwendet.If provider is null, the thread current culture is used.

Ein Decimal-Objekt hat 29 Ziffern mit präziser Genauigkeit.A Decimal object has 29 digits of precision. Wenn s eine Zahl darstellt, die mehr als 29 Ziffern hat, aber einen Bruch Teil hat und sich innerhalb des Bereichs von MaxValue und MinValuebefindet, wird die Zahl gerundet, nicht abgeschnitten, mit Rundung zum nächsten.If s represents a number that has more than 29 digits, but has a fractional part and is within the range of MaxValue and MinValue, the number is rounded, not truncated, to 29 digits using rounding to nearest.

Wenn während eines Analyse Vorgangs ein Trennzeichen im s-Parameter gefunden wird und die entsprechende Währungs-oder Zahlen Dezimal-und Gruppen Trennzeichen identisch sind, geht der Analyse Vorgang davon aus, dass das Trennzeichen ein Dezimaltrennzeichen und nicht ein Gruppen Trennzeichen ist.If a separator is encountered in the s parameter during a parse operation, and the applicable currency or number decimal and group separators are the same, the parse operation assumes that the separator is a decimal separator rather than a group separator. Weitere Informationen zu Trennzeichen finden Sie unter CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparatorund NumberGroupSeparator.For more information about separators, see CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparator, and NumberGroupSeparator.

Siehe auch

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

Konvertiert die Spannendarstellung einer Zahl unter Verwendung des angegebenen Stils und kulturspezifischer Formatierungsinformationen in die Decimal-Entsprechung.Converts the span representation of a number to its Decimal equivalent using the specified style and culture-specific format. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.A return value indicates whether the conversion succeeded or failed.

public:
 static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::Decimal % result);
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider provider, out decimal result);
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * decimal -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As Decimal) As Boolean

Parameter

s
ReadOnlySpan<Char>

Die Spanne mit den Zeichen, die die zu konvertierende Zahl darstellen.A span containing the characters representing the number to convert.

style
NumberStyles

Eine bitweise Kombination von Enumerationswerten, die das zulässige Format von s angibt.A bitwise combination of enumeration values that indicates the permitted format of s. Ein häufig angegebener Wert ist Number.A typical value to specify is Number.

provider
IFormatProvider

Ein Objekt, das kulturabhängige Analyseinformationen über s bereitstellt.An object that supplies culture-specific parsing information about s.

result
Decimal

Enthält bei Rückgabe dieser Methode die Decimal-Zahl, die dem numerischen Wert in s entspricht, wenn die Konvertierung erfolgreich ausgeführt wurde, oder 0 (null) bei einem Konvertierungsfehler.When this method returns, contains the Decimal number that is equivalent to the numeric value contained in s, if the conversion succeeded, or zero if the conversion failed. Bei der Konvertierung tritt ein Fehler auf, wenn der s-Parameter null oder Empty ist, nicht als Zahl in einem mit style kompatiblen Format vorliegt oder eine Zahl kleiner als MinValue oder größer als MaxValue darstellt.The conversion fails if the s parameter is null or Empty, is not a number in a format compliant with style, or represents a number less than MinValue or greater than MaxValue. Dieser Parameter wird nicht initialisiert übergeben; in result ursprünglich übergebene Werte werden ausnahmslos überschrieben.This parameter is passed uininitialized; any value originally supplied in result is overwritten.

Gibt zurück

true, wenn s erfolgreich konvertiert wurde, andernfalls false.true if s was converted successfully; otherwise, false.

TryParse(ReadOnlySpan<Char>, Decimal)

Konvertiert die Spannendarstellung einer Zahl unter Verwendung des angegebenen Stils und kulturspezifischer Formatierungsinformationen in die Decimal-Entsprechung.Converts the span representation of a number to its Decimal equivalent using the specified style and culture-specific format. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.A return value indicates whether the conversion succeeded or failed.

public:
 static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] System::Decimal % result);
public static bool TryParse (ReadOnlySpan<char> s, out decimal result);
static member TryParse : ReadOnlySpan<char> * decimal -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As Decimal) As Boolean

Parameter

s
ReadOnlySpan<Char>

Die Spanne mit den Zeichen, die die zu konvertierende Zahl darstellen.A span containing the characters representing the number to convert.

result
Decimal

Enthält bei Rückgabe dieser Methode die Decimal-Zahl, die dem numerischen Wert in s entspricht, wenn die Konvertierung erfolgreich ausgeführt wurde, oder 0 (null) bei einem Konvertierungsfehler.When this method returns, contains the Decimal number that is equivalent to the numeric value contained in s, if the conversion succeeded, or zero if the conversion failed. Bei der Konvertierung tritt ein Fehler auf, wenn der s-Parameter null oder Empty ist, nicht als Zahl in einem mit style kompatiblen Format vorliegt oder eine Zahl kleiner als MinValue oder größer als MaxValue darstellt.The conversion fails if the s parameter is null or Empty, is not a number in a format compliant with style, or represents a number less than MinValue or greater than MaxValue. Dieser Parameter wird nicht initialisiert übergeben; in result ursprünglich übergebene Werte werden ausnahmslos überschrieben.This parameter is passed uininitialized; any value originally supplied in result is overwritten.

Gibt zurück

true, wenn s erfolgreich konvertiert wurde, andernfalls false.true if s was converted successfully; otherwise, false.

TryParse(String, Decimal)

Wandelt die angegebene Zeichenfolgendarstellung einer Zahl in ihre Decimal-Entsprechung um.Converts the string representation of a number to its Decimal equivalent. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.A return value indicates whether the conversion succeeded or failed.

public:
 static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] System::Decimal % result);
public static bool TryParse (string s, out decimal result);
static member TryParse : string * decimal -> bool
Public Shared Function TryParse (s As String, ByRef result As Decimal) As Boolean

Parameter

s
String

Die Zeichenfolgendarstellung der zu konvertierenden Zahl.The string representation of the number to convert.

result
Decimal

Enthält bei Rückgabe dieser Methode die Decimal-Zahl, die dem numerischen Wert in s entspricht, wenn die Konvertierung erfolgreich ausgeführt wurde, oder 0 (null) bei einem Konvertierungsfehler.When this method returns, contains the Decimal number that is equivalent to the numeric value contained in s, if the conversion succeeded, or zero if the conversion failed. Bei der Konvertierung tritt ein Fehler auf, wenn der s-Parameter null oder Empty ist, keine Zahl in einem gültigen Format ist oder eine Zahl kleiner als MinValue oder größer als MaxValue ist.The conversion fails if the s parameter is null or Empty, is not a number in a valid format, or represents a number less than MinValue or greater than MaxValue. Dieser Parameter wird nicht initialisiert übergeben; in result ursprünglich übergebene Werte werden ausnahmslos überschrieben.This parameter is passed uininitialized; any value originally supplied in result is overwritten.

Gibt zurück

true, wenn s erfolgreich konvertiert wurde, andernfalls false.true if s was converted successfully; otherwise, false.

Beispiele

Im folgenden Beispiel wird die Decimal.TryParse(String, Decimal)-Methode verwendet, um die Zeichen folgen Darstellungen numerischer Werte in Decimal Werte zu konvertieren.The following example uses the Decimal.TryParse(String, Decimal) method to convert the string representations of numeric values to Decimal values. Dabei wird davon ausgegangen, dass "en-US" die aktuelle Kultur ist.It assumes that en-US is the current culture.

string value;
decimal number;

// Parse a floating-point value with a thousands separator.
value = "1,643.57";
if (Decimal.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 (Decimal.TryParse(value, out number))
   Console.WriteLine(number);
else
   Console.WriteLine("Unable to parse '{0}'.", value);   

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

// Parse a negative integer value.
value = "-1689346178821";
if (Decimal.TryParse(value, out number))
   Console.WriteLine(number);
else
   Console.WriteLine("Unable to parse '{0}'.", value);   
// The example displays the following output to the console:
//       1643.57
//       Unable to parse '$1,643.57'.
//       Unable to parse '-1.643e6'.
//       -1689346178821      
Dim value As String
Dim number As Decimal

' Parse a floating-point value with a thousands separator.
value = "1,643.57"
If Decimal.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 Decimal.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 Decimal.TryParse(value, number)
   Console.WriteLine(number)
Else
   Console.WriteLine("Unable to parse '{0}'.", value)   
End If

' Parse a negative integer value.
value = "-1689346178821"
If Decimal.TryParse(value, number)
   Console.WriteLine(number)
Else
   Console.WriteLine("Unable to parse '{0}'.", value)   
End If
' The example displays the following output to the console:
'       1643.57
'       Unable to parse '$1,643.57'.
'       Unable to parse '-1.643e6'.
'       -1689346178821      

Hinweise

Diese Überladung unterscheidet sich von der Decimal.Parse(String)-Methode, indem ein boolescher Wert zurückgegeben wird, der angibt, ob der Analyse Vorgang erfolgreich war, anstatt den analysierten numerischen Wert zurückzugeben.This overload differs from the Decimal.Parse(String) method by returning a Boolean value that indicates whether the parse operation succeeded instead of returning the parsed numeric value. Es entfällt, dass die Ausnahmebehandlung verwendet werden muss, um auf eine FormatException zu testen, wenn s ungültig ist und nicht erfolgreich analysiert werden kann.It eliminates the need to use exception handling to test for a FormatException in the event that s is invalid and cannot be successfully parsed.

Der Parameter s enthält eine Reihe von folgenden Formen:Parameter s contains a number of the form:

Gefangener Gebärden [Ziffern,] Ziffern [. Bruch Ziffern] [WS][ws][sign][digits,]digits[.fractional-digits][ws]

Elemente in eckigen Klammern ([ und ]) sind optional.Elements in square brackets ([ and ]) are optional. In der folgenden Tabelle wird jedes Element beschrieben.The following table describes each element.

ElementElement BeschreibungDescription
wsws Optionaler Leerraum.Optional white space.
signsign Ein optionales Vorzeichen.An optional sign.
Zifferndigits Eine Sequenz von Ziffern zwischen 0 und 9.A sequence of digits ranging from 0 to 9.
,, Ein kulturspezifisches Tausender Trennzeichen.A culture-specific thousands separator symbol.
.. Ein kulturspezifisches Dezimaltrennzeichen.A culture-specific decimal point symbol.
Bruch Ziffernfractional-digits Eine Sequenz von Ziffern zwischen 0 und 9.A sequence of digits ranging from 0 to 9.

Der Parameter s wird unter Verwendung des NumberStyles.Number Stils interpretiert.Parameter s is interpreted using the NumberStyles.Number style. Dies bedeutet, dass Leerzeichen und Tausender Trennzeichen zulässig sind, aber Währungssymbole nicht.This means that white space and thousands separators are allowed but currency symbols are not. Verwenden Sie die Decimal.TryParse(String, NumberStyles, IFormatProvider, Decimal)-Methoden Überladung, um die Elemente (z. b. Währungssymbole, Tausende Trennzeichen und Leerzeichen), die in svorhanden sein können, explizit zu definieren.To explicitly define the elements (such as currency symbols, thousands separators, and white space) that can be present in s, use the Decimal.TryParse(String, NumberStyles, IFormatProvider, Decimal) method overload.

Parameter s werden mithilfe der Formatierungsinformationen in einem NumberFormatInfo Objekt analysiert, das für die aktuelle System Kultur initialisiert wurde.Parameter s is parsed using the formatting information in a NumberFormatInfo object initialized for the current system culture. Weitere Informationen finden Sie unter CurrentInfo.For more information, see CurrentInfo. Verwenden Sie die Decimal.TryParse(String, NumberStyles, IFormatProvider, Decimal)-Methoden Überladung, um eine Zeichenfolge mit den Formatierungsinformationen einer anderen angegebenen Kultur zu analysieren.To parse a string using the formatting information of some other specified culture, use the Decimal.TryParse(String, NumberStyles, IFormatProvider, Decimal) method overload.

Bei Bedarf wird der Wert von s mit Rundung zum nächsten gerundet.If necessary, the value of s is rounded using rounding to nearest.

Ein Decimal-Objekt hat 29 Ziffern mit präziser Genauigkeit.A Decimal object has 29 digits of precision. Wenn s eine Zahl darstellt, die mehr als 29 Ziffern hat, aber einen Bruch Teil hat und sich innerhalb des Bereichs von MaxValue und MinValuebefindet, wird die Zahl gerundet, nicht abgeschnitten, mit Rundung zum nächsten.If s represents a number that has more than 29 digits, but has a fractional part and is within the range of MaxValue and MinValue, the number is rounded, not truncated, to 29 digits using rounding to nearest.

Wenn während eines Analyse Vorgangs ein Trennzeichen im s-Parameter gefunden wird und die entsprechende Währungs-oder Zahlen Dezimal-und Gruppen Trennzeichen identisch sind, geht der Analyse Vorgang davon aus, dass das Trennzeichen ein Dezimaltrennzeichen und nicht ein Gruppen Trennzeichen ist.If during a parse operation a separator is encountered in the s parameter, and the applicable currency or number decimal and group separators are the same, the parse operation assumes that the separator is a decimal separator rather than a group separator. Weitere Informationen zu Trennzeichen finden Sie unter CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparatorund NumberGroupSeparator.For more information about separators, see CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparator, and NumberGroupSeparator.

Siehe auch

Gilt für: