Byte.Parse Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Converte la rappresentazione di stringa di un numero nell'equivalente Byte .
Overload
| Nome | Descrizione |
|---|---|
| Parse(String, NumberStyles, IFormatProvider) |
Converte la rappresentazione di stringa di un numero in uno stile e un formato specifico delle impostazioni cultura specificati nell'equivalente Byte . |
| Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) |
Converte la rappresentazione dell'intervallo di un numero in uno stile e un formato specifico delle impostazioni cultura specificati nell'equivalente Byte . |
| Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider) |
Analizza un intervallo di caratteri UTF-8 in un valore. |
| Parse(String, IFormatProvider) |
Converte la rappresentazione di stringa di un numero in un formato specifico delle impostazioni cultura specificato nell'equivalente Byte . |
| Parse(String, NumberStyles) |
Converte la rappresentazione di stringa di un numero in uno stile specificato nell'equivalente Byte . |
| Parse(ReadOnlySpan<Char>, IFormatProvider) |
Analizza un intervallo di caratteri in un valore. |
| Parse(ReadOnlySpan<Byte>, IFormatProvider) |
Analizza un intervallo di caratteri UTF-8 in un valore. |
| Parse(String) |
Converte la rappresentazione di stringa di un numero nell'equivalente Byte . |
Parse(String, NumberStyles, IFormatProvider)
- Origine:
- Byte.cs
- Origine:
- Byte.cs
- Origine:
- Byte.cs
- Origine:
- Byte.cs
- Origine:
- Byte.cs
Converte la rappresentazione di stringa di un numero in uno stile e un formato specifico delle impostazioni cultura specificati nell'equivalente Byte .
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
Parametri
- s
- String
Stringa contenente un numero da convertire. La stringa viene interpretata usando lo stile specificato da style.
- style
- NumberStyles
Combinazione bit per bit di valori di enumerazione che indica gli elementi di stile che possono essere presenti in s. Un valore tipico da specificare è Integer.
- provider
- IFormatProvider
Oggetto che fornisce informazioni specifiche delle impostazioni cultura sul formato di s. Se provider è null, vengono utilizzate le impostazioni cultura correnti del thread.
Restituisce
Valore di byte equivalente al numero contenuto in s.
Implementazioni
Eccezioni
s è null.
s non è del formato corretto.
s rappresenta un numero minore di Byte.MinValue o maggiore di Byte.MaxValue.
oppure
s include cifre non zero, frazionarie.
style non è un NumberStyles valore.
oppure
style non è una combinazione di AllowHexSpecifier valori e HexNumber .
Esempio
Nell'esempio di codice seguente vengono analizzate le rappresentazioni di stringa dei Byte valori con questo overload del Byte.Parse(String, NumberStyles, IFormatProvider) metodo .
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.
Commenti
Il style parametro definisce gli elementi di stile,ad esempio lo spazio vuoto o il segno positivo, consentiti nel s parametro affinché l'operazione di analisi abbia esito positivo. Deve essere una combinazione di flag di bit dell'enumerazione NumberStyles . A seconda del valore di style, il s parametro può includere gli elementi seguenti:
[ws][$][sign]digits[.fractional_digits][e[sign]digits][ws]
In alternativa, se il style parametro include AllowHexSpecifier:
[ws]hexdigits[ws]
Gli elementi tra parentesi quadre ([ e ]) sono facoltativi. La tabella seguente descrive i singoli elementi.
| Elemento | Descrizione |
|---|---|
| Ws | Spazio vuoto facoltativo. Gli spazi vuoti possono essere visualizzati all'inizio di s se include il NumberStyles.AllowLeadingWhite flag o alla fine di s se style include il NumberStyles.AllowTrailingWhite flag .style |
| $ | Simbolo di valuta specifico delle impostazioni cultura. La posizione nella stringa è definita dalla NumberFormatInfo.CurrencyPositivePattern proprietà dell'oggetto NumberFormatInfo restituito dal GetFormat metodo del provider parametro . Il simbolo di valuta può essere visualizzato in s se style include il NumberStyles.AllowCurrencySymbol flag . |
| segno | Segno positivo facoltativo. Il metodo genera un'eccezione OverflowException se è presente un segno negativo in s. Il segno può essere visualizzato all'inizio di s se include il NumberStyles.AllowLeadingSign flag o alla fine di s se style include il NumberStyles.AllowTrailingSign flag.style |
| Cifre | Sequenza di cifre da 0 a 9. |
| . | Simbolo di virgola decimale specifica delle impostazioni cultura. Il simbolo di virgola decimale delle impostazioni cultura specificate da provider può essere visualizzato in s se style include il NumberStyles.AllowDecimalPoint flag . |
| Cifre_frazionarie | Una o più occorrenze della cifra 0. Le cifre frazionarie possono essere visualizzate solo s se style include il NumberStyles.AllowDecimalPoint flag . |
| e | Carattere e o E, che indica che il valore è rappresentato nella notazione esponenziale. Il parametro s può rappresentare un numero in notazione esponenziale se style include il NumberStyles.AllowExponent flag . |
| hexdigits | Sequenza di cifre esadecimali da 0 a f o da 0 a F. |
Annotazioni
Qualsiasi carattere di terminazione NUL (U+0000) in s viene ignorato dall'operazione di analisi, indipendentemente dal valore dell'argomento style .
Una stringa con solo cifre decimali (che corrisponde allo NumberStyles.None stile) analizza sempre correttamente. La maggior parte degli elementi di controllo membri rimanenti NumberStyles che possono essere ma non devono essere presenti in questa stringa di input. La tabella seguente indica in che modo i singoli NumberStyles membri influiscono sugli elementi che possono essere presenti in s.
| Valori NumberStyles non compositi | Elementi consentiti in s oltre alle cifre |
|---|---|
| NumberStyles.None | Solo cifre decimali. |
| NumberStyles.AllowDecimalPoint | Elementi . e fractional_digits . Tuttavia, fractional_digits deve essere costituito da una o più cifre 0 o viene generata un'eccezione OverflowException . |
| NumberStyles.AllowExponent | Il s parametro può anche usare la notazione esponenziale. |
| NumberStyles.AllowLeadingWhite | Elemento ws all'inizio di s. |
| NumberStyles.AllowTrailingWhite | Elemento ws alla fine di s. |
| NumberStyles.AllowLeadingSign | Un segno positivo può essere visualizzato prima delle cifre. |
| NumberStyles.AllowTrailingSign | Un segno positivo può apparire dopo le cifre. |
| NumberStyles.AllowParentheses | Anche se questo flag è supportato, l'uso delle parentesi genera s un oggetto OverflowException. |
| NumberStyles.AllowThousands | Anche se il simbolo separatore di gruppo può essere visualizzato in s, può essere preceduto da una o più cifre 0. |
| NumberStyles.AllowCurrencySymbol | Elemento $ . |
Se viene usato il NumberStyles.AllowHexSpecifier flag, s deve essere un valore esadecimale senza un prefisso. Ad esempio, "F3" analizza correttamente, ma "0xF3" non. Gli unici flag che possono essere presenti in style sono NumberStyles.AllowLeadingWhite e NumberStyles.AllowTrailingWhite. L'enumerazione NumberStyles ha uno stile numerico composito, NumberStyles.HexNumber, che include entrambi i flag di spazio vuoto.
Il provider parametro è un'implementazione IFormatProvider , ad esempio un NumberFormatInfo oggetto o CultureInfo . Il provider parametro fornisce informazioni specifiche delle impostazioni cultura usate nell'analisi. Se provider è null, vengono utilizzate le impostazioni cultura correnti del thread.
Vedi anche
- ToString()
- MaxValue
- MinValue
- NumberStyles
- NumberFormatInfo
- IFormatProvider
- Formattazione dei tipi in .NET
Si applica a
Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)
- Origine:
- Byte.cs
- Origine:
- Byte.cs
- Origine:
- Byte.cs
- Origine:
- Byte.cs
- Origine:
- Byte.cs
Converte la rappresentazione dell'intervallo di un numero in uno stile e un formato specifico delle impostazioni cultura specificati nell'equivalente Byte .
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
Parametri
- s
- ReadOnlySpan<Char>
Intervallo contenente i caratteri che rappresentano il valore da convertire.
- style
- NumberStyles
Combinazione bit per bit di valori di enumerazione che indica gli elementi di stile che possono essere presenti in s. Un valore tipico da specificare è Integer.
- provider
- IFormatProvider
Oggetto che fornisce informazioni specifiche delle impostazioni cultura sul formato di s. Se provider è null, vengono utilizzate le impostazioni cultura correnti del thread.
Restituisce
Valore di byte equivalente al numero contenuto in s.
Implementazioni
Si applica a
Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)
- Origine:
- Byte.cs
- Origine:
- Byte.cs
- Origine:
- Byte.cs
- Origine:
- Byte.cs
Analizza un intervallo di caratteri UTF-8 in un valore.
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
Parametri
- utf8Text
- ReadOnlySpan<Byte>
Intervallo di caratteri UTF-8 da analizzare.
- style
- NumberStyles
Combinazione bit per bit di stili numerici che possono essere presenti in utf8Text.
- provider
- IFormatProvider
Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura su utf8Text.
Restituisce
Risultato dell'analisi utf8Textdi .
Implementazioni
Si applica a
Parse(String, IFormatProvider)
- Origine:
- Byte.cs
- Origine:
- Byte.cs
- Origine:
- Byte.cs
- Origine:
- Byte.cs
- Origine:
- Byte.cs
Converte la rappresentazione di stringa di un numero in un formato specifico delle impostazioni cultura specificato nell'equivalente Byte .
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
Parametri
- s
- String
Stringa contenente un numero da convertire. La stringa viene interpretata usando lo Integer stile .
- provider
- IFormatProvider
Oggetto che fornisce informazioni di analisi specifiche delle impostazioni cultura su s. Se provider è null, vengono utilizzate le impostazioni cultura correnti del thread.
Restituisce
Valore di byte equivalente al numero contenuto in s.
Implementazioni
Eccezioni
s è null.
s non è del formato corretto.
s rappresenta un numero minore di Byte.MinValue o maggiore di Byte.MaxValue.
Esempio
Nell'esempio seguente vengono analizzate le rappresentazioni di stringa dei Byte valori con il Parse metodo .
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.
Commenti
Il s parametro contiene un numero di form:
[ws][sign]digits[ws]
Gli elementi tra parentesi quadre ([ e ]) sono facoltativi. La tabella seguente descrive i singoli elementi.
| Elemento | Descrizione |
|---|---|
| Ws | Spazio vuoto facoltativo. |
| segno | Segno positivo facoltativo. |
| Cifre | Sequenza di cifre compresa tra 0 e 9. |
Il s parametro viene interpretato usando lo Integer stile . Oltre alle cifre decimali del valore di byte, sono consentiti solo gli spazi iniziali e finali insieme a un segno iniziale. Se il segno è presente, deve essere un segno positivo o il metodo genera un'eccezione OverflowException. Per definire in modo esplicito gli elementi di stile insieme alle informazioni di formattazione specifiche delle impostazioni cultura che possono essere presenti in s, usare il Byte.Parse(String, NumberStyles, IFormatProvider) metodo .
Il s parametro viene analizzato usando le informazioni di formattazione in un NumberFormatInfo oggetto fornito da provider. Il provider parametro è un'implementazione IFormatProvider , ad esempio un NumberFormatInfo oggetto o CultureInfo . Il provider parametro fornisce informazioni specifiche delle impostazioni cultura usate nell'analisi. Se provider è null, vengono utilizzate le impostazioni cultura correnti del thread.
Vedi anche
- ToString()
- TryParse
- MaxValue
- MinValue
- NumberStyles
- NumberFormatInfo
- IFormatProvider
- Formattazione dei tipi in .NET
Si applica a
Parse(String, NumberStyles)
- Origine:
- Byte.cs
- Origine:
- Byte.cs
- Origine:
- Byte.cs
- Origine:
- Byte.cs
- Origine:
- Byte.cs
Converte la rappresentazione di stringa di un numero in uno stile specificato nell'equivalente Byte .
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
Parametri
- s
- String
Stringa contenente un numero da convertire. La stringa viene interpretata usando lo stile specificato da style.
- style
- NumberStyles
Combinazione bit per bit di valori di enumerazione che indica gli elementi di stile che possono essere presenti in s. Un valore tipico da specificare è Integer.
Restituisce
Valore di byte equivalente al numero contenuto in s.
Eccezioni
s è null.
s non è del formato corretto.
s rappresenta un numero minore di Byte.MinValue o maggiore di Byte.MaxValue.
oppure
s include cifre non zero, frazionarie.
style non è un NumberStyles valore.
oppure
style non è una combinazione di AllowHexSpecifier valori e HexNumber .
Esempio
Nell'esempio seguente vengono analizzate le rappresentazioni di stringa dei Byte valori con il Byte.Parse(String, NumberStyles) metodo . Le impostazioni cultura correnti per l'esempio sono 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.
Commenti
Il style parametro definisce gli elementi di stile,ad esempio lo spazio vuoto o il segno positivo, consentiti nel s parametro affinché l'operazione di analisi abbia esito positivo. Deve essere una combinazione di flag di bit dell'enumerazione NumberStyles . A seconda del valore di style, il s parametro può includere gli elementi seguenti:
[ws][$][sign]digits[.fractional_digits][e[sign]digits][ws]
In alternativa, se style include AllowHexSpecifier:
[ws]hexdigits[ws]
Gli elementi tra parentesi quadre ([ e ]) sono facoltativi. La tabella seguente descrive i singoli elementi.
| Elemento | Descrizione |
|---|---|
| Ws | Spazio vuoto facoltativo. Gli spazi vuoti possono essere visualizzati all'inizio di s se include il NumberStyles.AllowLeadingWhite flag o alla fine di s se lo stile include il NumberStyles.AllowTrailingWhitestyle flag. |
| $ | Simbolo di valuta specifico delle impostazioni cultura. La posizione nella stringa è definita dalla NumberFormatInfo.CurrencyPositivePattern proprietà delle impostazioni cultura correnti. Il simbolo di valuta delle impostazioni cultura corrente può essere visualizzato in s se style include il NumberStyles.AllowCurrencySymbol flag . |
| segno | Segno positivo facoltativo. Il metodo genera un'eccezione OverflowException se è presente un segno negativo in s. Il segno può essere visualizzato all'inizio di s se include il NumberStyles.AllowLeadingSign flag o alla fine di s se style include il NumberStyles.AllowTrailingSign flag.style |
| Cifre | Sequenza di cifre da 0 a 9. |
| . | Simbolo di virgola decimale specifica delle impostazioni cultura. Il simbolo del separatore decimale delle impostazioni cultura corrente può essere visualizzato in s se style include il NumberStyles.AllowDecimalPoint flag . |
| Cifre_frazionarie | Una o più occorrenze della cifra 0. Le cifre frazionarie possono essere visualizzate solo s se style include il NumberStyles.AllowDecimalPoint flag . |
| e | Carattere e o E, che indica che il valore è rappresentato nella notazione esponenziale. Il s parametro può rappresentare un numero in notazione esponenziale se style include il NumberStyles.AllowExponent flag . |
| hexdigits | Sequenza di cifre esadecimali da 0 a f o da 0 a F. |
Annotazioni
Qualsiasi carattere di terminazione NUL (U+0000) in s viene ignorato dall'operazione di analisi, indipendentemente dal valore dell'argomento style .
Una stringa con solo cifre decimali (che corrisponde allo NumberStyles.None stile) analizza sempre correttamente. La maggior parte degli elementi di controllo membri rimanenti NumberStyles che possono essere ma non devono essere presenti in questa stringa di input. La tabella seguente indica in che modo i singoli NumberStyles membri influiscono sugli elementi che possono essere presenti in s.
| Valori NumberStyles non compositi | Elementi consentiti in s oltre alle cifre |
|---|---|
| NumberStyles.None | Solo cifre decimali. |
| NumberStyles.AllowDecimalPoint | Elementi . e fractional_digits . Tuttavia, fractional_digits deve essere costituito da una o più cifre 0 o viene generata un'eccezione OverflowException . |
| NumberStyles.AllowExponent | Il s parametro può anche usare la notazione esponenziale. |
| NumberStyles.AllowLeadingWhite | Elemento ws all'inizio di s. |
| NumberStyles.AllowTrailingWhite | Elemento ws alla fine di s. |
| NumberStyles.AllowLeadingSign | Un segno positivo può essere visualizzato prima delle cifre. |
| NumberStyles.AllowTrailingSign | Un segno positivo può apparire dopo le cifre. |
| NumberStyles.AllowParentheses | Anche se questo flag è supportato, l'uso delle parentesi genera s un oggetto OverflowException. |
| NumberStyles.AllowThousands | Anche se il simbolo separatore di gruppo può essere visualizzato in s, può essere preceduto da una o più cifre 0. |
| NumberStyles.AllowCurrencySymbol | Elemento $ . |
Se viene usato il NumberStyles.AllowHexSpecifier flag, s deve essere un valore esadecimale senza un prefisso. Ad esempio, "F3" analizza correttamente, ma "0xF3" non. Gli unici flag che possono essere combinati con esso sono NumberStyles.AllowLeadingWhite e NumberStyles.AllowTrailingWhite. L'enumerazione NumberStyles include uno stile numerico composito, NumberStyles.HexNumber, che include entrambi i flag di spazio vuoto.
Il s parametro viene analizzato usando le informazioni di formattazione in un NumberFormatInfo oggetto inizializzato per le impostazioni cultura di sistema correnti. Per usare le informazioni di formattazione di altre impostazioni cultura, chiamare l'overload Byte.Parse(String, NumberStyles, IFormatProvider) .
Vedi anche
- ToString()
- TryParse
- MaxValue
- MinValue
- NumberStyles
- NumberFormatInfo
- IFormatProvider
- Formattazione dei tipi in .NET
Si applica a
Parse(ReadOnlySpan<Char>, IFormatProvider)
- Origine:
- Byte.cs
- Origine:
- Byte.cs
- Origine:
- Byte.cs
- Origine:
- Byte.cs
- Origine:
- Byte.cs
Analizza un intervallo di caratteri in un valore.
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
Parametri
- s
- ReadOnlySpan<Char>
Intervallo di caratteri da analizzare.
- provider
- IFormatProvider
Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura su s.
Restituisce
Risultato dell'analisi sdi .
Implementazioni
Si applica a
Parse(ReadOnlySpan<Byte>, IFormatProvider)
- Origine:
- Byte.cs
- Origine:
- Byte.cs
- Origine:
- Byte.cs
- Origine:
- Byte.cs
Analizza un intervallo di caratteri UTF-8 in un valore.
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
Parametri
- utf8Text
- ReadOnlySpan<Byte>
Intervallo di caratteri UTF-8 da analizzare.
- provider
- IFormatProvider
Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura su utf8Text.
Restituisce
Risultato dell'analisi utf8Textdi .
Implementazioni
Si applica a
Parse(String)
- Origine:
- Byte.cs
- Origine:
- Byte.cs
- Origine:
- Byte.cs
- Origine:
- Byte.cs
- Origine:
- Byte.cs
Converte la rappresentazione di stringa di un numero nell'equivalente Byte .
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
Parametri
- s
- String
Stringa contenente un numero da convertire. La stringa viene interpretata usando lo Integer stile .
Restituisce
Valore di byte equivalente al numero contenuto in s.
Eccezioni
s è null.
s non è del formato corretto.
s rappresenta un numero minore di Byte.MinValue o maggiore di Byte.MaxValue.
Esempio
Nell'esempio seguente viene illustrato come convertire un valore stringa in un valore di byte usando il Byte.Parse(String) metodo . Il valore di byte risultante viene quindi visualizzato nella console.
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.
Commenti
Il s parametro contiene un numero di form:
[ws][sign]digits[ws]
Gli elementi tra parentesi quadre ([ e ]) sono facoltativi. La tabella seguente descrive i singoli elementi.
| Elemento | Descrizione |
|---|---|
| Ws | Spazio vuoto facoltativo. |
| segno | Segno positivo o negativo facoltativo. |
| Cifre | Sequenza di cifre compresa tra 0 e 9. |
Il s parametro viene interpretato usando lo NumberStyles.Integer stile . Oltre alle cifre decimali del valore di byte, sono consentiti solo gli spazi iniziali e finali insieme a un segno iniziale. Se il segno è presente, deve essere un segno positivo o il metodo genera un'eccezione OverflowException. Per definire in modo esplicito gli elementi di stile che possono essere presenti in s, utilizzare il Byte.Parse(String, NumberStyles) metodo o Byte.Parse(String, NumberStyles, IFormatProvider) .
Il s parametro viene analizzato usando le informazioni di formattazione in un NumberFormatInfo oggetto inizializzato per le impostazioni cultura di sistema correnti. Per altre informazioni, vedere CurrentInfo. Per analizzare una stringa usando le informazioni di formattazione di altre impostazioni cultura, usare il Byte.Parse(String, NumberStyles, IFormatProvider) metodo .
Vedi anche
- ToString()
- MaxValue
- MinValue
- NumberStyles
- NumberFormatInfo
- Analisi di stringhe numeriche in .NET
- Formattazione dei tipi in .NET