Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo Byte.Parse (String, NumberStyles)

 

Data di pubblicazione: ottobre 2016

Converte la rappresentazione di stringa di un numero in uno stile specificato nell'oggetto Byte equivalente.

Spazio dei nomi:   System
Assembly:  mscorlib (in mscorlib.dll)

public static byte Parse(
	string s,
	NumberStyles style
)

Parametri

s
Type: System.String

Stringa che contiene un numero da convertire. La stringa viene interpreta usando lo stile specificato da style.

style
Type: System.Globalization.NumberStyles

Combinazione bit per bit dei valori di enumerazione che indica gli elementi di stile che possono essere presenti in s. Un valore tipico da specificare è NumberStyles.Integer.

Valore restituito

Type: System.Byte

Valore di byte equivalente al numero contenuto in s.

Exception Condition
ArgumentNullException

s è null.

FormatException

s non è nel formato corretto.

OverflowException

s rappresenta un numero minore di Byte.MinValue o maggiore di Byte.MaxValue.

-oppure-

s include cifre frazionarie diverse da zero.

ArgumentException

style non è un valore di NumberStyles.

-oppure-

style non è una combinazione di valori di NumberStyles.AllowHexSpecifier e NumberStyles.HexNumber.

Il style parametro definisce gli elementi di stile (ad esempio spazio vuoto o il segno positivo) che sono consentiti nel s parametro per l'operazione di analisi abbia esito positivo. Deve essere una combinazione di flag di bit del NumberStyles enumerazione. A seconda del valore di style, s parametro può includere gli elementi seguenti:

[ws] [$] cifre [accesso] [cifre frazionarie] [[accesso] e cifre] [ws]

In alternativa, se style include AllowHexSpecifier:

[cifre esadecimali ws] [ws]

Gli elementi tra parentesi quadre ([e]) sono facoltativi. Nella tabella seguente viene descritto ogni elemento.

Elemento

Descrizione

ws

Spazio vuoto facoltativo. Gli spazi vuoti possono essere visualizzati all'inizio di s se style include il NumberStyles.AllowLeadingWhite flag o alla fine di s se style include il NumberStyles.AllowTrailingWhite flag.

$

Un simbolo di valuta delle impostazioni cultura specifiche. La posizione nella stringa è definita per il NumberFormatInfo.CurrencyPositivePattern proprietà delle impostazioni cultura correnti. Simbolo di valuta le impostazioni cultura correnti può apparire s se style include il NumberStyles.AllowCurrencySymbol flag.

segno

Un segno positivo facoltativo. (Il metodo genera un OverflowException se è presente un segno negativo s.) Il segno può essere visualizzati all'inizio di s se style include il NumberStyles.AllowLeadingSign flag o alla fine di s se style include il NumberStyles.AllowTrailingSign flag.

cifre

Una sequenza di cifre da 0 a 9.

.

Simbolo di separatore decimale delle impostazioni cultura specifiche. Simbolo di separatore decimale della lingua corrente può essere visualizzati s se style include il NumberStyles.AllowDecimalPoint flag.

frazionarie

Una o più occorrenze della cifra 0. Cifre frazionarie possono essere visualizzati s solo se style include il NumberStyles.AllowDecimalPoint flag.

h

Il 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.

cifre esadecimali

Una sequenza di cifre esadecimali da 0 a f, o da 0 a F.

Una stringa con solo cifre decimali (che corrisponde alla NumberStyles.None stile) viene sempre analizzata correttamente. La maggior parte degli altri NumberStyles membri controllano gli elementi che possono essere ma non devono essere presenti in questa stringa di input. Nella tabella seguente indica come singoli NumberStyles membri interessano gli elementi che possono essere presenti in s.

Valori NumberStyles non compositi

Elementi consentiti in s oltre alle cifre

NumberStyles.None

Cifre decimali.

NumberStyles.AllowDecimalPoint

Il . e frazionarie elementi. Tuttavia, frazionarie deve essere costituito solo da uno o più cifre 0 o un OverflowException viene generata un'eccezione.

NumberStyles.AllowExponent

Il s parametro inoltre possibile utilizzare la notazione esponenziale.

NumberStyles.AllowLeadingWhite

Il ws elemento all'inizio di s.

NumberStyles.AllowTrailingWhite

Il ws elemento alla fine di s.

NumberStyles.AllowLeadingSign

Può precedere un segno positivo cifre.

NumberStyles.AllowTrailingSign

Può essere presente un segno positivo dopo cifre.

NumberStyles.AllowParentheses

Anche se questo flag è supportato, l'utilizzo di parentesi in s comporta un OverflowException.

NumberStyles.AllowThousands

Anche se il simbolo di separatore di gruppi può essere visualizzati s, può essere preceduto da solo uno o più cifre 0.

NumberStyles.AllowCurrencySymbol

Il $ elemento.

Se il NumberStyles.AllowHexSpecifier flag viene utilizzato, s deve essere un valore esadecimale senza prefisso. Ad esempio, "F3" viene analizzata correttamente, ma non "0xF3". Sono gli unici altri flag che possono essere combinati con esso NumberStyles.AllowLeadingWhite e NumberStyles.AllowTrailingWhite. (Il NumberStyles enumerazione include uno stile di numero composto, NumberStyles.HexNumber, che include entrambi i flag di spazi vuoti.)

Il s parametro viene analizzato utilizzando le informazioni di formattazione in un NumberFormatInfo oggetto inizializzato per la lingua corrente. Per utilizzare le informazioni di formattazione di altre impostazioni cultura, chiamare il Byte.Parse(String, NumberStyles, IFormatProvider) rapporto di overload.

Nell'esempio seguente consente di analizzare le rappresentazioni di stringa di Byte con i valori di Byte.Parse(String, NumberStyles) metodo. Per l'esempio di impostazioni cultura correnti 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.            

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 1.1
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: