Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Byte.Parse-Methode: (String, NumberStyles, IFormatProvider)

 

Veröffentlicht: Oktober 2016

Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und kulturabhängigen Format in das entsprechende Byte.

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

public static byte Parse(
	string s,
	NumberStyles style,
	IFormatProvider provider
)

Parameter

s
Type: System.String

Eine Zeichenfolge, die eine zu konvertierende Zahl enthält. Die Zeichenfolge wird unter Verwendung des durch style angegebenen Formats interpretiert.

style
Type: System.Globalization.NumberStyles

Eine bitweise Kombination von Enumerationswerten, die die Stilelemente angeben, die in s vorhanden sein können. Ein häufig angegebener Wert ist NumberStyles.Integer.

provider
Type: System.IFormatProvider

Ein Objekt, das kulturspezifische Informationen zum Format von s bereitstellt. Wenn provider gleich null ist, wird die aktuelle Threadkultur verwendet.

Rückgabewert

Type: System.Byte

Ein Bytewert, der der Zahl in s entspricht.

Exception Condition
ArgumentNullException

s ist null.

FormatException

s weist nicht das richtige Format auf.

OverflowException

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

- oder -

s enthält Dezimalstellen ungleich 0 (null).

ArgumentException

style ist kein NumberStyles-Wert.

- oder -

style ist keine Kombination von NumberStyles.AllowHexSpecifier- und NumberStyles.HexNumber-Werten.

Die style Parameter definiert die Style-Elemente (z. B. leer- oder das positiven Vorzeichen), die in zulässig sind die s Parameter, damit der Analysevorgang erfolgreich ausgeführt werden kann. Es muss eine Kombination von Bitflags aus der NumberStyles Enumeration. Abhängig vom Wert der styledie s -Parameter enthält möglicherweise die folgenden Elemente:

[ws] [$] [Anmeldung] Ziffern [.fractional_digits] [-e [Anmeldung] Ziffern] [ws]

Oder, wenn die style Parameter enthält AllowHexSpecifier:

[ws] Hexdigits [ws]

Elemente in eckigen Klammern ([ und ]) sind optional. In der folgenden Tabelle wird jedes Element beschrieben.

Element

Beschreibung

ws

Optionaler Leerraum. Leerzeichen am Anfang stehen s Wenn style enthält die NumberStyles.AllowLeadingWhite Flag oder am Ende der s Wenn style enthält die NumberStyles.AllowTrailingWhite Flag.

$

Eine kulturspezifische Währungssymbol. Seine Position in der Zeichenfolge wird definiert, indem die NumberFormatInfo.CurrencyPositivePattern Eigenschaft von der NumberFormatInfo zurückgegebenes Objekt die GetFormat Methode der provider Parameter. Das Währungssymbol stehen s Wenn style enthält die NumberStyles.AllowCurrencySymbol Flag.

Vorzeichen

Ein optionalen positiven Vorzeichen. (Die Methode löst eine OverflowException ist ein negativen Vorzeichen vorhanden s.) Die Zeichen am Anfang stehen s Wenn style enthält die NumberStyles.AllowLeadingSign Flag oder am Ende der s Wenn style enthält die NumberStyles.AllowTrailingSign Flag.

Ziffern

Eine Folge von Ziffern zwischen 0 und 9.

.

Eine kulturspezifische Dezimaltrennzeichen. Das Dezimaltrennzeichen des vom angegebenen Kultur provider erscheinen s Wenn style enthält die NumberStyles.AllowDecimalPoint Flag.

Bruchziffern

Mindestens ein Vorkommen der Ziffer 0. Dezimalstellen erscheinen s nur, wenn style enthält die NumberStyles.AllowDecimalPoint Flag.

e

Das e oder E-Zeichen, das gibt an, dass der Wert in Exponentialschreibweise dargestellt wird. Die s-Parameter kann eine Zahl in Exponentialschreibweise darstellen, wenn style enthält die NumberStyles.AllowExponent Flag.

hexdigits

Eine Sequenz von hexadezimalen Ziffern von 0 bis f oder 0 bis f.

Eine Zeichenfolge mit nur Dezimalstellen (entspricht der NumberStyles.None Stil) immer erfolgreich analysiert. Die meisten der verbleibenden NumberStyles Member steuern Elemente, die nicht unbedingt in dieser Eingabezeichenfolge vorhanden sein. In der folgenden Tabelle gibt an, wie einzelne NumberStyles Mitglieder Auswirkungen auf die Elemente, die möglicherweise vorhandene in s.

Nicht zusammengesetzte NumberStyles-Werte

Elemente in s neben Ziffern zulässig

NumberStyles.None

Nur Dezimalstellen.

NumberStyles.AllowDecimalPoint

Die . und Bruchziffern Elemente. Allerdings Bruchziffern muss lediglich eine oder mehrere 0-Ziffern bestehen oder eine OverflowException ausgelöst wird.

NumberStyles.AllowExponent

Die s Parameter können auch Exponentialschreibweise.

NumberStyles.AllowLeadingWhite

Die ws Element am Anfang des s.

NumberStyles.AllowTrailingWhite

Die ws Element am Ende der s.

NumberStyles.AllowLeadingSign

Ein positiven Vorzeichen können angezeigt werden, bevor Sie Ziffern.

NumberStyles.AllowTrailingSign

Ein positiven Vorzeichen stehen nach Ziffern.

NumberStyles.AllowParentheses

Dieses Flag wird zwar unterstützt, die Verwendung von Klammern in s führt zu einer OverflowException.

NumberStyles.AllowThousands

Obwohl das Gruppentrennzeichen angezeigt, in werden kann s, es kann nur eine oder mehrere 0-Ziffern stehen.

NumberStyles.AllowCurrencySymbol

Die $ Element.

Wenn die NumberStyles.AllowHexSpecifier -Flag wird verwendet, s Hexadezimalwert ohne Präfix werden muss. Z. B. "F3" erfolgreich analysiert, "0xF3" jedoch nicht. Die einzigen anderen Flags, die im vorhanden sein können style sind NumberStyles.AllowLeadingWhite und NumberStyles.AllowTrailingWhite. (Die NumberStyles -Enumeration hat ein zusammengesetztes Zahlenformat NumberStyles.HexNumber, beide Flags Leerzeichen enthält.)

Die provider Parameter ist ein IFormatProvider Implementierung, z. B. eine NumberFormatInfo oder CultureInfo Objekt. Die provider Parameter liefert kulturspezifische Informationen, die bei der Analyse verwendet. Wenn provider gleich null ist, wird die aktuelle Threadkultur verwendet.

Im folgenden Codebeispiel wird analysiert zeichenfolgendarstellungen Byte Werte mit dieser Überladung von der Byte.Parse(String, NumberStyles, IFormatProvider) Methode.

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

// Parse number with decimals.
// NumberStyles.Float includes NumberStyles.AllowDecimalPoint.
style = NumberStyles.Float;     
culture = CultureInfo.CreateSpecificCulture("fr-FR");
value = "12,000";

number = Byte.Parse(value, style, culture);
Console.WriteLine("Converted '{0}' to {1}.", value, number);

culture = CultureInfo.CreateSpecificCulture("en-GB");
try
{
   number = Byte.Parse(value, style, culture);
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", value); }   

value = "12.000";
number = Byte.Parse(value, style, culture);
Console.WriteLine("Converted '{0}' to {1}.", value, number);
// The example displays the following output to the console:
//       Converted '12,000' to 12.
//       Unable to parse '12,000'.
//       Converted '12.000' to 12.

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: