(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

SByte.TryParse-Methode (String, SByte)

Versucht, die Zeichenfolgendarstellung einer Zahl in deren SByte-Entsprechung zu konvertieren, und gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich durchgeführt wurde.

Diese API ist nicht CLS-kompatibel. 

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

[CLSCompliantAttribute(false)]
public static bool TryParse(
	string s,
	out sbyte result
)

Parameter

s
Typ: System.String
Eine Zeichenfolge, die die zu konvertierende Zahl enthält.
result
Typ: System.SByte
Diese Methode gibt bei erfolgreicher Konvertierung den 8-Bit-Ganzzahlwert mit Vorzeichen zurück, der der Zahl in s entspricht, und 0 (null), wenn die Konvertierung nicht durchgeführt werden konnte. Die Konvertierung kann nicht durchgeführt werden, wenn der s-Parameter null oder String.Empty ist, kein gültiges Format aufweist oder eine Zahl kleiner als MinValue oder größer als MaxValue darstellt. Dieser Parameter wird nicht initialisiert übergeben.

Rückgabewert

Typ: System.Boolean
true , wenn s erfolgreich konvertiert wurde, andernfalls false.

Die SByte.TryParse(String, SByte)-Methode entspricht der SByte.Parse(String)-Methode, mit dem Unterschied, dass diese Methode bei einem Konvertierungsfehler keine Ausnahme auslöst. Aufgrund dieser Methode muss keine Ausnahmebehandlung ausgeführt werden, um einen Test auf eine FormatException auszuführen, wenn value ungültig ist und nicht erfolgreich analysiert werden kann.

Der s-Parameter muss der Zeichenfolgendarstellung einer Dezimalzahl im folgenden Format entsprechen:

[LR][Vorzeichen]Ziffern[LR]

Elemente in eckigen Klammern ("["und"]") sind optional. In der folgenden Tabelle werden die einzelnen Elemente beschrieben.

Element

Beschreibung

LR

Optionaler Leerraum.

sign

Ein optionales Vorzeichen. Gültige Zeichen für Vorzeichen werden durch die NumberFormatInfo.NegativeSign-Eigenschaft und die NumberFormatInfo.PositiveSign-Eigenschaft für die aktuelle Kultur bestimmt.

Ziffern

Eine Folge von Dezimalziffern zwischen 0 und 9.

HinweisHinweis

Die vom value-Parameter angegebene Zeichenfolge kann nicht beliebige Gruppentrennzeichen oder Dezimaltrennzeichen enthalten und darf keine Nachkommastellen besitzen.

Der s-Parameter wird mithilfe des NumberStyles.Integer-Stils interpretiert. Neben den Dezimalziffern sind nur führende und nachgestellte Leerzeichen mit einem vorangestellten Vorzeichen zulässig. Wenn Sie die Stilelemente mit den kulturspezifischen Formatierungsinformationen explizit definieren möchten, die in value vorhanden sein können, rufen Sie die TryParse(String, NumberStyles, IFormatProvider, SByte)-Methode auf.

Der s-Parameter wird mithilfe der Formatierungsinformationen in einem NumberFormatInfo-Objekt für die aktuelle Kultur analysiert. Weitere Informationen finden Sie unter NumberFormatInfo.CurrentInfo.

Diese Überladung interpretiert alle Ziffern im value-Parameter als Dezimalstellen. Rufen Sie stattdessen die TryParse(String, NumberStyles, IFormatProvider, SByte)-Überladung auf, um die Zeichenfolgendarstellung einer Hexadezimalzahl zu analysieren.

Im folgenden Beispiel wird versucht, die Zeichenfolgen in einem Array in SByte-Werte zu konvertieren, indem die TryParse(String, SByte)-Methode aufgerufen wird.


string[] numericStrings = {"-3.6", "12.8", "+16.7", "    3   ", "(17)", 
                           "-17", "+12", "18-", "987", "1,024", "  127 "};
sbyte number;
foreach (string numericString in numericStrings)
{
   if (sbyte.TryParse(numericString, out number)) 
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number);
   else
      Console.WriteLine("Cannot convert '{0}' to an SByte.", numericString);
}
// The example displays the following output to the console:
//       Cannot convert '-3.6' to an SByte.
//       Cannot convert '12.8' to an SByte.
//       Cannot convert '+16.7' to an SByte.
//       Converted '    3   ' to 3.
//       Cannot convert '(17)' to an SByte.
//       Converted '-17' to -17.
//       Converted '+12' to 12.
//       Cannot convert '18-' to an SByte.
//       Cannot convert '987' to an SByte.
//       Cannot convert '1,024' to an SByte.
//       Converted '  127 ' to 127.


.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Portable Klassenbibliothek

Unterstützt in: Portable Klassenbibliothek

.NET für Windows Store-Apps

Unterstützt in: Windows 8

.NET für Windows Phone-Apps

Unterstützt in: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft