Exportieren (0) 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

Int64.Parse-Methode (String, IFormatProvider)

Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen kulturabhängigen Format in die entsprechende 64-Bit-Ganzzahl mit Vorzeichen.

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

public static long Parse(
	string s,
	IFormatProvider provider
)

Parameter

s
Typ: System.String
Eine Zeichenfolge, die die zu konvertierende Zahl enthält.
provider
Typ: System.IFormatProvider
Ein Objekt, das kulturspezifische Formatierungsinformationen über s bereitstellt.

Rückgabewert

Typ: System.Int64
Eine 64-Bit-Ganzzahl mit Vorzeichen, die der Zahl in s entspricht.

AusnahmeBedingung
ArgumentNullException

s ist null.

FormatException

s hat nicht das richtige Format.

OverflowException

s stellt eine Zahl dar, die kleiner als MinValue oder größer als MaxValue ist.

Diese Überladung der Parse(String, IFormatProvider)-Methode wird normalerweise zum Konvertieren von Text verwendet, der auf unterschiedliche Arten als Int64-Wert formatiert werden kann. Hiermit kann z. B. der von einem Benutzer eingegebene Text in einem HTML-Textfeld in einen numerischen Wert konvertiert werden.

Der s-Parameter enthält eine Zahl der folgenden Form:

[LR][Vorzeichen]Ziffern[LR]

Elemente in eckigen Klammern ("[" und "]") sind optional. Es gibt folgende weitere Elemente.

LR

Optionaler Leerraum.

sign

Ein optionales Vorzeichen.

Ziffern

Eine Folge von Ziffern zwischen 0 (null) und 9.

Der s-Parameter wird unter Verwendung des NumberStyles.Integer-Stils interpretiert. Neben den Dezimalziffern sind nur führende und nachgestellte Leerzeichen sowie ein vorangestelltes Vorzeichen zulässig. Wenn Sie die Stilelemente explizit definieren möchten, die in s vorhanden sein können, verwenden Sie die Int64.Parse(String, NumberStyles, IFormatProvider)-Methode.

Der provider-Parameter ist eine IFormatProvider-Implementierung, z. B. ein NumberFormatInfo-Objekt oder CultureInfo-Objekt. Der provider-Parameter stellt kulturspezifische Informationen zum Format von s bereit. Wenn providernull ist, wird die NumberFormatInfo für die aktuelle Kultur verwendet.

Im folgenden Beispiel wird der Ereignishandler für das Click-Ereignis eines Web Forms veranschaulicht. Es wird das von der HttpRequest.UserLanguages-Eigenschaft zurückgegebene Array verwendet, um das Gebietsschema des Benutzers zu bestimmen. Danach wird ein CultureInfo-Objekt instanziiert, das diesem Gebietsschema entspricht. Das zu diesem CultureInfo-Objekt gehörende NumberFormatInfo-Objekt wird dann an die Parse(String, IFormatProvider)-Methode übergeben, um die Benutzereingabe in einen Int64-Wert zu konvertieren.


protected void OkToLong_Click(object sender, EventArgs e)
{
   string locale;
   long 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 = Int64.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();
}


.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.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:
© 2015 Microsoft