Byte.Parse Methode

Definition

Namespace:: System

Assemblys:: mscorlib.dll, System.Runtime.dll

Assemblys:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Konvertiert die Zeichenfolgendarstellung einer Zahl in die Byte entsprechende Zahl.

Überlädt

Name	Beschreibung
Parse(String, NumberStyles, IFormatProvider)	Konvertiert die Zeichenfolgendarstellung einer Zahl in einer angegebenen Formatvorlage und einem kulturspezifischen Format in das Byte entsprechende Format.
Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)	Konvertiert die Spandarstellung einer Zahl in einer angegebenen Formatvorlage und einem kulturspezifischen Format in das Byte entsprechende Format.
Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)	Analysiert eine Spanne von UTF-8 Zeichen in einen Wert.
Parse(String, IFormatProvider)	Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen kulturspezifischen Format in das Byte entsprechende Format.
Parse(String, NumberStyles)	Konvertiert die Zeichenfolgendarstellung einer Zahl in einer angegebenen Formatvorlage in das Byte entsprechende Format.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Analysiert eine Spanne von Zeichen in einen Wert.
Parse(ReadOnlySpan<Byte>, IFormatProvider)	Analysiert eine Spanne von UTF-8 Zeichen in einen Wert.
Parse(String)	Konvertiert die Zeichenfolgendarstellung einer Zahl in die Byte entsprechende Zahl.

Parse(String, NumberStyles, IFormatProvider)

Quelle:: Byte.cs

Quelle:: Byte.cs

Quelle:: Byte.cs

Quelle:: Byte.cs

Quelle:: Byte.cs

Konvertiert die Zeichenfolgendarstellung einer Zahl in einer angegebenen Formatvorlage und einem kulturspezifischen Format in das Byte entsprechende Format.

public:
 static System::Byte Parse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider);

public:
 static System::Byte Parse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider) = System::Numerics::INumberBase<System::Byte>::Parse;

public static byte Parse(string s, System.Globalization.NumberStyles style, IFormatProvider provider);

public static byte Parse(string s, System.Globalization.NumberStyles style, IFormatProvider? provider);

static member Parse : string * System.Globalization.NumberStyles * IFormatProvider -> byte

Public Shared Function Parse (s As String, style As NumberStyles, provider As IFormatProvider) As Byte

Parameter

s: String

Eine Zeichenfolge, die eine zahl enthält, die konvertiert werden soll. Die Zeichenfolge wird mithilfe der durch style.

style: NumberStyles

Eine bitweise Kombination von Enumerationswerten, die die Formatvorlagenelemente angibt, in sdenen vorhanden sein kann. Ein typischer Wert, der angegeben werden soll, ist Integer.

provider: IFormatProvider

Ein Objekt, das kulturspezifische Informationen zum Format von s. Ist provider dies nullder Grund, wird die aktuelle Threadkultur verwendet.

Gibt zurück

Byte

Ein Bytewert, der der zahl entspricht, die in s.

Implementiert

Parse(String, NumberStyles, IFormatProvider)

Ausnahmen

ArgumentNullException

s ist null.

FormatException

s ist nicht das richtige Format.

OverflowException

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

- oder -

s enthält Nicht-Null-Dezimalstellen.

ArgumentException

style ist kein NumberStyles Wert.

- oder -

style ist keine Kombination von AllowHexSpecifier und HexNumber Werten.

Beispiele

Im folgenden Codebeispiel werden Zeichenfolgendarstellungen von Byte Werten mit dieser Überladung der Byte.Parse(String, NumberStyles, IFormatProvider) Methode analysiert.

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.

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

let number = Byte.Parse(value, style, culture)
printfn $"Converted '{value}' to {number}."

let culture = CultureInfo.CreateSpecificCulture "en-GB"
try
    let number = Byte.Parse(value, style, culture)
    printfn $"Converted '{value}' to {number}."
with :? FormatException ->
    printfn $"Unable to parse '{value}'."

let value = "12.000"
let number = Byte.Parse(value, style, culture)
printfn $"Converted '{value}' to {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.

Dim style As NumberStyles
Dim culture As CultureInfo
Dim value As String
Dim number As Byte

' 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 e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", value)   
End Try      

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.

Hinweise

Der style Parameter definiert die Formatvorlagenelemente (z. B. Leerzeichen oder das positive Zeichen), die im s Parameter zulässig sind, damit der Analysevorgang erfolgreich ausgeführt werden kann. Es muss eine Kombination aus Bitkennzeichnungen aus der NumberStyles Enumeration sein. Je nach Wert kann styleder s Parameter die folgenden Elemente enthalten:

[ws][$][Sign]digits[.fractional_digits][e[sign]digits][ws]

Oder, wenn der style Parameter Folgendes 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 können am Anfang angezeigt `s` werden, wenn `style` die NumberStyles.AllowLeadingWhite Kennzeichnung enthalten ist, oder am Ende, `s` wenn `style` die NumberStyles.AllowTrailingWhite Kennzeichnung enthalten ist.
$	Ein kulturspezifisches Währungssymbol. Die Position in der Zeichenfolge wird durch die NumberFormatInfo.CurrencyPositivePattern Eigenschaft des Objekts definiert, das NumberFormatInfo von der GetFormat Methode des `provider` Parameters zurückgegeben wird. Das Währungssymbol kann angezeigt werden, wenn `s` das `style` Kennzeichen enthalten NumberStyles.AllowCurrencySymbol ist.
Zeichen	Ein optionales positives Zeichen. (Die Methode löst ein OverflowException , wenn ein negatives Zeichen in `s`.) Das Zeichen kann am Anfang des `s` Zeichens angezeigt werden, wenn `style` die NumberStyles.AllowLeadingSign Kennzeichnung enthalten ist, oder am Ende, `s` wenn `style` die NumberStyles.AllowTrailingSign Kennzeichnung enthalten ist.
Ziffern	Eine Sequenz von Ziffern von 0 bis 9.
.	Ein kulturspezifisches Dezimalkommasymbol. Das Dezimalkommasymbol der durch diese Kultur angegebenen `provider` Kultur kann angezeigt werden `s` , wenn `style` die NumberStyles.AllowDecimalPoint Kennzeichnung enthalten ist.
fractional_digits	Mindestens ein Vorkommen der Ziffer 0. Dezimalstellen können nur angezeigt werden `s` , wenn `style` die NumberStyles.AllowDecimalPoint Kennzeichnung enthalten ist.
e	Das E- oder E-Zeichen, das angibt, dass der Wert in exponentieller Schreibweise dargestellt wird. Der s-Parameter kann eine Zahl in exponentieller Notation darstellen, wenn `style` die NumberStyles.AllowExponent Kennzeichnung enthalten ist.
hexdigits	Eine Abfolge von hexadezimalen Ziffern von 0 bis f oder 0 bis F.

Hinweis

Alle endenden NUL-Zeichen s (U+0000) werden unabhängig vom Wert des style Arguments vom Analysevorgang ignoriert.

Eine Zeichenfolge mit dezimalen Ziffern (die der NumberStyles.None Formatvorlage entspricht) analysiert immer erfolgreich. Die meisten der verbleibenden NumberStyles Elemente steuern Elemente, die möglicherweise vorhanden, aber nicht in dieser Eingabezeichenfolge vorhanden sein müssen. In der folgenden Tabelle wird angegeben, wie sich einzelne NumberStyles Member auf die Elemente auswirken, die möglicherweise svorhanden sind.

Nicht zusammengesetzte NumberStyles-Werte	Elemente, die zusätzlich zu Ziffern in s zulässig sind
NumberStyles.None	Nur Dezimalziffern.
NumberStyles.AllowDecimalPoint	Die Elemente . und fractional_digits . Fractional_digits darf jedoch nur aus einer oder mehreren 0 Ziffern bestehen oder wird OverflowException ausgelöst.
NumberStyles.AllowExponent	Der `s` Parameter kann auch exponentielle Notation verwenden.
NumberStyles.AllowLeadingWhite	Das ws-Element am Anfang von `s`.
NumberStyles.AllowTrailingWhite	Das ws-Element am Ende von `s`.
NumberStyles.AllowLeadingSign	Ein positives Zeichen kann vor Ziffern angezeigt werden.
NumberStyles.AllowTrailingSign	Ein positives Zeichen kann nach Ziffern angezeigt werden.
NumberStyles.AllowParentheses	Obwohl dieses Flag unterstützt wird, führt die Verwendung von Klammern in `s` einem OverflowException.
NumberStyles.AllowThousands	Obwohl das Gruppentrennzeichen in `s`angezeigt werden kann, kann es nur einer oder mehreren Ziffern vorangestellt werden.
NumberStyles.AllowCurrencySymbol	Das $ Element.

Wenn das NumberStyles.AllowHexSpecifier Flag verwendet wird, s muss es sich um einen Hexadezimalwert ohne Präfix sein. Beispielsweise analysiert "F3" erfolgreich, aber "0xF3" nicht. Die einzigen anderen Flags, die style vorhanden sein können, sind NumberStyles.AllowLeadingWhite und NumberStyles.AllowTrailingWhite. (Die NumberStyles Aufzählung weist eine zusammengesetzte Zahlenformatvorlage auf, NumberStyles.HexNumberdie beide Leerzeichen-Flags enthält.)

Der provider Parameter ist eine IFormatProvider Implementierung, z. B. ein Objekt oder CultureInfo ein NumberFormatInfo Objekt. Der provider Parameter liefert kulturspezifische Informationen, die bei der Analyse verwendet werden. Ist provider dies nullder Grund, wird die aktuelle Threadkultur verwendet.

Weitere Informationen

Gilt für:

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

Quelle:: Byte.cs

Quelle:: Byte.cs

Quelle:: Byte.cs

Quelle:: Byte.cs

Quelle:: Byte.cs

Konvertiert die Spandarstellung einer Zahl in einer angegebenen Formatvorlage und einem kulturspezifischen Format in das Byte entsprechende Format.

public static byte Parse(ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider? provider = default);

public static byte Parse(ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider provider = default);

static member Parse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider -> byte

Public Shared Function Parse (s As ReadOnlySpan(Of Char), Optional style As NumberStyles = System.Globalization.NumberStyles.Integer, Optional provider As IFormatProvider = Nothing) As Byte

Parameter

s: ReadOnlySpan<Char>

Ein Bereich mit den Zeichen, die den zu konvertierenden Wert darstellen.

style: NumberStyles

Eine bitweise Kombination von Enumerationswerten, die die Formatvorlagenelemente angibt, in sdenen vorhanden sein kann. Ein typischer Wert, der angegeben werden soll, ist Integer.

provider: IFormatProvider

Ein Objekt, das kulturspezifische Informationen zum Format von s. Ist provider dies nullder Grund, wird die aktuelle Threadkultur verwendet.

Gibt zurück

Byte

Ein Bytewert, der der zahl entspricht, die in s.

Implementiert

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

Gilt für:

Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)

Quelle:: Byte.cs

Quelle:: Byte.cs

Quelle:: Byte.cs

Quelle:: Byte.cs

Analysiert eine Spanne von UTF-8 Zeichen in einen Wert.

public static byte Parse(ReadOnlySpan<byte> utf8Text, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider? provider = default);

static member Parse : ReadOnlySpan<byte> * System.Globalization.NumberStyles * IFormatProvider -> byte

Public Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte), Optional style As NumberStyles = System.Globalization.NumberStyles.Integer, Optional provider As IFormatProvider = Nothing) As Byte

Parameter

utf8Text: ReadOnlySpan<Byte>

Die Spanne von UTF-8 Zeichen, die analysiert werden sollen.

style: NumberStyles

Eine bitweise Kombination aus Zahlenformatvorlagen, die vorhanden utf8Textsein können.

provider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu utf8Text.

Gibt zurück

Byte

Das Ergebnis der Analyse utf8Text.

Implementiert

Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)

Gilt für:

Parse(String, IFormatProvider)

Quelle:: Byte.cs

Quelle:: Byte.cs

Quelle:: Byte.cs

Quelle:: Byte.cs

Quelle:: Byte.cs

Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen kulturspezifischen Format in das Byte entsprechende Format.

public:
 static System::Byte Parse(System::String ^ s, IFormatProvider ^ provider);

public:
 static System::Byte Parse(System::String ^ s, IFormatProvider ^ provider) = IParsable<System::Byte>::Parse;

public static byte Parse(string s, IFormatProvider provider);

public static byte Parse(string s, IFormatProvider? provider);

static member Parse : string * IFormatProvider -> byte

Public Shared Function Parse (s As String, provider As IFormatProvider) As Byte

Parameter

s: String

Eine Zeichenfolge, die eine zahl enthält, die konvertiert werden soll. Die Zeichenfolge wird mithilfe der Integer Formatvorlage interpretiert.

provider: IFormatProvider

Ein Objekt, das kulturspezifische Analyseinformationen zu s. Ist provider dies nullder Grund, wird die aktuelle Threadkultur verwendet.

Gibt zurück

Byte

Ein Bytewert, der der zahl entspricht, die in s.

Implementiert

Parse(String, IFormatProvider)

Ausnahmen

ArgumentNullException

s ist null.

FormatException

s ist nicht das richtige Format.

OverflowException

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

Beispiele

Im folgenden Beispiel werden Zeichenfolgendarstellungen von Byte Werten mit der Parse Methode analysiert.

string stringToConvert;
byte byteValue;

stringToConvert = " 214 ";
try {
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert); }
catch (OverflowException) {
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.",
                     stringToConvert, Byte.MaxValue, Byte.MinValue); }

stringToConvert = " + 214 ";
try {
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert); }
catch (OverflowException) {
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.",
                     stringToConvert, Byte.MaxValue, Byte.MinValue); }

stringToConvert = " +214 ";
try {
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert); }
catch (OverflowException) {
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.",
                     stringToConvert, Byte.MaxValue, Byte.MinValue); }
// The example displays the following output to the console:
//       Converted ' 214 ' to 214.
//       Unable to parse ' + 214 '.
//       Converted ' +214 ' to 214.

let stringToConvert = " 214 "
try
    let byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
    printfn $"Converted '{stringToConvert}' to {byteValue}." 
with
| :? FormatException ->
    printfn $"Unable to parse '{stringToConvert}'."
| :? OverflowException ->
    printfn $"'{stringToConvert}' is greater than {Byte.MaxValue} or less than {Byte.MinValue}." 

let stringToConvert = " + 214 "
try
    let byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
    printfn $"Converted '{stringToConvert}' to {byteValue}." 
with
| :? FormatException ->
    printfn $"Unable to parse '{stringToConvert}'."
| :? OverflowException ->
    printfn $"'{stringToConvert}' is greater than {Byte.MaxValue} or less than {Byte.MinValue}." 

let stringToConvert = " +214 "
try
    let byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
    printfn $"Converted '{stringToConvert}' to {byteValue}." 
with
| :? FormatException ->
    printfn $"Unable to parse '{stringToConvert}'."
| :? OverflowException ->
    printfn $"'{stringToConvert}' is greater than {Byte.MaxValue} or less than {Byte.MinValue}." 

// The example displays the following output to the console:
//       Converted ' 214 ' to 214.
//       Unable to parse ' + 214 '.
//       Converted ' +214 ' to 214.

Dim stringToConvert As String 
Dim byteValue As Byte

stringToConvert = " 214 "
Try
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", _
                     stringToConvert, Byte.MaxValue, Byte.MinValue)
End Try  

stringToConvert = " + 214 "
Try
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", _
                     stringToConvert, Byte.MaxValue, Byte.MinValue)
End Try  

stringToConvert = " +214 "
Try
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", _
                     stringToConvert, Byte.MaxValue, Byte.MinValue)
End Try
' The example displays the following output to the console:
'       Converted ' 214 ' to 214.
'       Unable to parse ' + 214 '.
'       Converted ' +214 ' to 214.

Hinweise

Der s Parameter enthält eine Zahl des Formulars:

[ws][Zeichen]Ziffern[ws]

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

Element	Beschreibung
Ws	Optionaler Leerraum.
Zeichen	Ein optionales positives Zeichen.
Ziffern	Eine Sequenz von Ziffern zwischen 0 und 9.

Der s Parameter wird mithilfe der Integer Formatvorlage interpretiert. Neben den Dezimalstellen des Bytewerts sind nur führende und nachfolgende Leerzeichen zusammen mit einem vorangestellten Zeichen zulässig. (Wenn das Zeichen vorhanden ist, muss es ein positives Zeichen sein, oder die Methode löst ein OverflowException.) Wenn Sie die Formatvorlagenelemente explizit zusammen mit den kulturspezifischen Formatierungsinformationen definieren möchten, die vorhanden ssein können, verwenden Sie die Byte.Parse(String, NumberStyles, IFormatProvider) Methode.

Der s Parameter wird mithilfe der Formatierungsinformationen in einem NumberFormatInfo objekt analysiert, das von provider. Der provider Parameter ist eine IFormatProvider Implementierung, z. B. ein NumberFormatInfo Objekt oder CultureInfo ein Objekt. Der provider Parameter liefert kulturspezifische Informationen, die bei der Analyse verwendet werden. Ist provider dies nullder Grund, wird die aktuelle Threadkultur verwendet.

Weitere Informationen

Gilt für:

Parse(String, NumberStyles)

Quelle:: Byte.cs

Quelle:: Byte.cs

Quelle:: Byte.cs

Quelle:: Byte.cs

Quelle:: Byte.cs

Konvertiert die Zeichenfolgendarstellung einer Zahl in einer angegebenen Formatvorlage in das Byte entsprechende Format.

public:
 static System::Byte Parse(System::String ^ s, System::Globalization::NumberStyles style);

public static byte Parse(string s, System.Globalization.NumberStyles style);

static member Parse : string * System.Globalization.NumberStyles -> byte

Public Shared Function Parse (s As String, style As NumberStyles) As Byte

Parameter

s: String

Eine Zeichenfolge, die eine zahl enthält, die konvertiert werden soll. Die Zeichenfolge wird mithilfe der durch style.

style: NumberStyles

Eine bitweise Kombination von Enumerationswerten, die die Formatvorlagenelemente angibt, in sdenen vorhanden sein kann. Ein typischer Wert, der angegeben werden soll, ist Integer.

Gibt zurück

Byte

Ein Bytewert, der der zahl entspricht, die in s.

Ausnahmen

ArgumentNullException

s ist null.

FormatException

s ist nicht das richtige Format.

OverflowException

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

- oder -

s enthält Nicht-Null-Dezimalstellen.

ArgumentException

style ist kein NumberStyles Wert.

- oder -

style ist keine Kombination von AllowHexSpecifier und HexNumber Werten.

Beispiele

Im folgenden Beispiel werden Zeichenfolgendarstellungen von Byte Werten mit der Byte.Parse(String, NumberStyles) Methode analysiert. Die aktuelle Kultur für das Beispiel ist en-US.

string value;
NumberStyles style;
byte number;

// Parse value with no styles allowed.
style = NumberStyles.None;
value = " 241 ";
try
{
   number = Byte.Parse(value, style);
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", value); }

// Parse value with trailing sign.
style = NumberStyles.Integer | NumberStyles.AllowTrailingSign;
value = " 163+";
number = Byte.Parse(value, style);
Console.WriteLine("Converted '{0}' to {1}.", value, number);

// Parse value with leading sign.
value = "   +253  ";
number = Byte.Parse(value, style);
Console.WriteLine("Converted '{0}' to {1}.", value, number);
// This example displays the following output to the console:
//       Unable to parse ' 241 '.
//       Converted ' 163+' to 163.
//       Converted '   +253  ' to 253.

// Parse value with no styles allowed.
let style = NumberStyles.None
let value = " 241 "
try
    let number = Byte.Parse(value, style);
    printfn $"Converted '{value}' to {number}."
with :? FormatException ->
    printfn $"Unable to parse '{value}'."

// Parse value with trailing sign.
let style = NumberStyles.Integer ||| NumberStyles.AllowTrailingSign
let value = " 163+"
let number = Byte.Parse(value, style)
printfn $"Converted '{value}' to {number}."

// Parse value with leading sign.
let value = "   +253  "
let number = Byte.Parse(value, style)
printfn $"Converted '{value}' to {number}."

// This example displays the following output to the console:
//       Unable to parse ' 241 '.
//       Converted ' 163+' to 163.
//       Converted '   +253  ' to 253.

Dim value As String
Dim style As NumberStyles
Dim number As Byte

' Parse value with no styles allowed.
style = NumberStyles.None
value = " 241 "
Try
   number = Byte.Parse(value, style)
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", value)   
End Try
  
' Parse value with trailing sign.
style = NumberStyles.Integer Or NumberStyles.AllowTrailingSign
value = " 163+"
number = Byte.Parse(value, style)
Console.WriteLine("Converted '{0}' to {1}.", value, number)

' Parse value with leading sign.
value = "   +253  "
number = Byte.Parse(value, style)
Console.WriteLine("Converted '{0}' to {1}.", value, number)
' This example displays the following output to the console:
'       Unable to parse ' 241 '.
'       Converted ' 163+' to 163.
'       Converted '   +253  ' to 253.

Hinweise

[ws][$][Sign]digits[.fractional_digits][e[sign]digits][ws]

Oder, wenn style umfasst 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 können am Anfang der `sstyle`NumberStyles.AllowLeadingWhite Kennzeichnung oder am Ende von s angezeigt werden, wenn die Formatvorlage die NumberStyles.AllowTrailingWhite Kennzeichnung enthält.
$	Ein kulturspezifisches Währungssymbol. Die Position in der Zeichenfolge wird durch die NumberFormatInfo.CurrencyPositivePattern Eigenschaft der aktuellen Kultur definiert. Das Währungssymbol der aktuellen Kultur kann angezeigt werden `s` , wenn `style` die NumberStyles.AllowCurrencySymbol Kennzeichnung enthalten ist.
Zeichen	Ein optionales positives Zeichen. (Die Methode löst ein OverflowException , wenn ein negatives Zeichen in `s`.) Das Zeichen kann am Anfang des `s` Zeichens angezeigt werden, wenn `style` die NumberStyles.AllowLeadingSign Kennzeichnung enthalten ist, oder am Ende, `s` wenn `style` die NumberStyles.AllowTrailingSign Kennzeichnung enthalten ist.
Ziffern	Eine Sequenz von Ziffern von 0 bis 9.
.	Ein kulturspezifisches Dezimalkommasymbol. Das Dezimalkommasymbol der aktuellen Kultur kann angezeigt werden `s` , wenn `style` das NumberStyles.AllowDecimalPoint Kennzeichen enthalten ist.
fractional_digits	Mindestens ein Vorkommen der Ziffer 0. Dezimalstellen können nur angezeigt werden `s` , wenn `style` die NumberStyles.AllowDecimalPoint Kennzeichnung enthalten ist.
e	Das E- oder E-Zeichen, das angibt, dass der Wert in exponentieller Schreibweise dargestellt wird. Der `s` Parameter kann eine Zahl in exponentieller Notation darstellen, wenn `style` das NumberStyles.AllowExponent Flag enthalten ist.
hexdigits	Eine Abfolge von hexadezimalen Ziffern von 0 bis f oder 0 bis F.

Hinweis

Alle endenden NUL-Zeichen s (U+0000) werden unabhängig vom Wert des style Arguments vom Analysevorgang ignoriert.

Nicht zusammengesetzte NumberStyles-Werte	Elemente, die zusätzlich zu Ziffern in s zulässig sind
NumberStyles.None	Nur Dezimalziffern.
NumberStyles.AllowDecimalPoint	Die Elemente . und fractional_digits . Fractional_digits darf jedoch nur aus einer oder mehreren 0 Ziffern bestehen oder wird OverflowException ausgelöst.
NumberStyles.AllowExponent	Der `s` Parameter kann auch exponentielle Notation verwenden.
NumberStyles.AllowLeadingWhite	Das ws-Element am Anfang von `s`.
NumberStyles.AllowTrailingWhite	Das ws-Element am Ende von `s`.
NumberStyles.AllowLeadingSign	Ein positives Zeichen kann vor Ziffern angezeigt werden.
NumberStyles.AllowTrailingSign	Ein positives Zeichen kann nach Ziffern angezeigt werden.
NumberStyles.AllowParentheses	Obwohl dieses Flag unterstützt wird, führt die Verwendung von Klammern in `s` einem OverflowException.
NumberStyles.AllowThousands	Obwohl das Gruppentrennzeichen in `s`angezeigt werden kann, kann es nur einer oder mehreren Ziffern vorangestellt werden.
NumberStyles.AllowCurrencySymbol	Das $ Element.

Wenn das NumberStyles.AllowHexSpecifier Flag verwendet wird, s muss es sich um einen Hexadezimalwert ohne Präfix sein. Beispielsweise analysiert "F3" erfolgreich, aber "0xF3" nicht. Die einzigen anderen Flags, die mit ihr kombiniert werden können, sind NumberStyles.AllowLeadingWhite und NumberStyles.AllowTrailingWhite. (Die NumberStyles Aufzählung enthält eine zusammengesetzte Zahlenformatvorlage, NumberStyles.HexNumberdie beide Leerzeichen-Flags enthält.)

Der s Parameter wird mithilfe der Formatierungsinformationen in einem NumberFormatInfo Objekt analysiert, das für die aktuelle Systemkultur initialisiert wird. Um die Formatierungsinformationen einer anderen Kultur zu verwenden, rufen Sie die Byte.Parse(String, NumberStyles, IFormatProvider) Überladung auf.

Weitere Informationen

Gilt für:

Parse(ReadOnlySpan<Char>, IFormatProvider)

Quelle:: Byte.cs

Quelle:: Byte.cs

Quelle:: Byte.cs

Quelle:: Byte.cs

Quelle:: Byte.cs

Analysiert eine Spanne von Zeichen in einen Wert.

public:
 static System::Byte Parse(ReadOnlySpan<char> s, IFormatProvider ^ provider) = ISpanParsable<System::Byte>::Parse;

public static byte Parse(ReadOnlySpan<char> s, IFormatProvider? provider);

static member Parse : ReadOnlySpan<char> * IFormatProvider -> byte

Public Shared Function Parse (s As ReadOnlySpan(Of Char), provider As IFormatProvider) As Byte

Parameter

s: ReadOnlySpan<Char>

Die Spanne der zu analysierenden Zeichen.

provider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu s.

Gibt zurück

Byte

Das Ergebnis der Analyse s.

Implementiert

Parse(ReadOnlySpan<Char>, IFormatProvider)

Gilt für:

Parse(ReadOnlySpan<Byte>, IFormatProvider)

Quelle:: Byte.cs

Quelle:: Byte.cs

Quelle:: Byte.cs

Quelle:: Byte.cs

Analysiert eine Spanne von UTF-8 Zeichen in einen Wert.

public:
 static System::Byte Parse(ReadOnlySpan<System::Byte> utf8Text, IFormatProvider ^ provider) = IUtf8SpanParsable<System::Byte>::Parse;

public static byte Parse(ReadOnlySpan<byte> utf8Text, IFormatProvider? provider);

static member Parse : ReadOnlySpan<byte> * IFormatProvider -> byte

Public Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider) As Byte

Parameter

utf8Text: ReadOnlySpan<Byte>

Die Spanne von UTF-8 Zeichen, die analysiert werden sollen.

provider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu utf8Text.

Gibt zurück

Byte

Das Ergebnis der Analyse utf8Text.

Implementiert

Parse(ReadOnlySpan<Byte>, IFormatProvider)

Gilt für:

Parse(String)

Quelle:: Byte.cs

Quelle:: Byte.cs

Quelle:: Byte.cs

Quelle:: Byte.cs

Quelle:: Byte.cs

Konvertiert die Zeichenfolgendarstellung einer Zahl in die Byte entsprechende Zahl.

public:
 static System::Byte Parse(System::String ^ s);

public static byte Parse(string s);

static member Parse : string -> byte

Public Shared Function Parse (s As String) As Byte

Parameter

s: String

Eine Zeichenfolge, die eine zahl enthält, die konvertiert werden soll. Die Zeichenfolge wird mithilfe der Integer Formatvorlage interpretiert.

Gibt zurück

Byte

Ein Bytewert, der der zahl entspricht, die in s.

Ausnahmen

ArgumentNullException

s ist null.

FormatException

s ist nicht das richtige Format.

OverflowException

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

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein Zeichenfolgenwert mithilfe der Byte.Parse(String) Methode in einen Bytewert konvertiert wird. Der resultierende Bytewert wird dann in der Konsole angezeigt.

string stringToConvert = " 162";
byte byteValue;
try
{
   byteValue = Byte.Parse(stringToConvert);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException)
{
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert);
}
catch (OverflowException)
{
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.",
                     stringToConvert, Byte.MaxValue, Byte.MinValue);
}
// The example displays the following output to the console:
//       Converted ' 162' to 162.

let stringToConvert = " 162"
try
    let byteValue = Byte.Parse stringToConvert
    printfn $"Converted '{stringToConvert}' to {byteValue}."
with
| :? FormatException ->
    printfn $"Unable to parse '{stringToConvert}'."
| :? OverflowException ->
    printfn $"'{stringToConvert}' is greater than {Byte.MaxValue} or less than {Byte.MinValue}."

// The example displays the following output to the console:
//       Converted ' 162' to 162.

Dim stringToConvert As String = " 162"
Dim byteValue As Byte
Try
   byteValue = Byte.Parse(stringToConvert)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", _
                     stringToConvert, Byte.MaxValue, Byte.MinValue)
End Try  
' The example displays the following output to the console:
'       Converted ' 162' to 162.

Hinweise

Der s Parameter enthält eine Zahl des Formulars:

[ws][Zeichen]Ziffern[ws]

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

Element	Beschreibung
Ws	Optionaler Leerraum.
Zeichen	Ein optionales positives oder negatives Zeichen.
Ziffern	Eine Sequenz von Ziffern zwischen 0 und 9.

Der s Parameter wird mithilfe der NumberStyles.Integer Formatvorlage interpretiert. Neben den Dezimalstellen des Bytewerts sind nur führende und nachfolgende Leerzeichen zusammen mit einem vorangestellten Zeichen zulässig. (Wenn das Zeichen vorhanden ist, muss es ein positives Zeichen sein, oder die Methode löst ein OverflowException.) Verwenden Sie zum expliziten Definieren der Formatvorlagenelemente, die vorhanden ssein können, entweder die Byte.Parse(String, NumberStyles) Methode oder die Byte.Parse(String, NumberStyles, IFormatProvider) Methode.

Der s Parameter wird mithilfe der Formatierungsinformationen in einem NumberFormatInfo Objekt analysiert, das für die aktuelle Systemkultur initialisiert wird. Weitere Informationen finden Sie unter CurrentInfo. Verwenden Sie die Byte.Parse(String, NumberStyles, IFormatProvider) Methode, um eine Zeichenfolge mithilfe der Formatierungsinformationen einer anderen Kultur zu analysieren.

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?

Freigeben über

Byte.Parse Methode

Definition

Überlädt

Parse(String, NumberStyles, IFormatProvider)

Parameter

Gibt zurück

Implementiert

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

Parameter

Gibt zurück

Implementiert

Gilt für:

Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)

Parameter

Gibt zurück

Implementiert

Gilt für:

Parse(String, IFormatProvider)

Parameter

Gibt zurück

Implementiert

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Parse(String, NumberStyles)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Parse(ReadOnlySpan<Char>, IFormatProvider)

Parameter

Gibt zurück

Implementiert

Gilt für:

Parse(ReadOnlySpan<Byte>, IFormatProvider)

Parameter

Gibt zurück

Implementiert

Gilt für:

Parse(String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Feedback