SByte.TryParse 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 intero con segno a 8 bit. Un codice restituito indica se la conversione ha avuto esito positivo o negativo.
Overload
TryParse(ReadOnlySpan<Byte>, IFormatProvider, SByte) |
Tenta di analizzare un intervallo di caratteri UTF-8 in un valore. |
TryParse(ReadOnlySpan<Char>, SByte) |
Prova a convertire la rappresentazione intervallo di un numero nell'oggetto SByte equivalente e restituisce un valore che indica se la conversione è stata eseguita correttamente. |
TryParse(String, SByte) |
Prova a convertire la rappresentazione di stringa di un numero nell'oggetto SByte equivalente e restituisce un valore che indica se la conversione è stata eseguita correttamente. |
TryParse(ReadOnlySpan<Char>, IFormatProvider, SByte) |
Tenta di analizzare un intervallo di caratteri in un valore. |
TryParse(String, IFormatProvider, SByte) |
Tenta di analizzare una stringa in un valore. |
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, SByte) |
Tenta di analizzare un intervallo di caratteri UTF-8 in un valore. |
TryParse(ReadOnlySpan<Byte>, SByte) |
Tenta di convertire un intervallo di caratteri UTF-8 contenente la rappresentazione di stringa di un numero nell'equivalente intero con segno a 8 bit. |
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, SByte) |
Prova a convertire la rappresentazione intervallo di un numero in uno stile specificato e un formato specifico delle impostazioni cultura indicato nel valore SByte equivalente e restituisce un valore che indica se la conversione è stata eseguita correttamente. |
TryParse(String, NumberStyles, IFormatProvider, SByte) |
Prova a convertire la rappresentazione di stringa di un numero in uno stile specificato e un formato specifico delle impostazioni cultura indicato nell'oggetto SByte equivalente e restituisce un valore che indica se la conversione è stata eseguita correttamente. |
TryParse(ReadOnlySpan<Byte>, IFormatProvider, SByte)
- Origine:
- SByte.cs
- Origine:
- SByte.cs
Tenta di analizzare un intervallo di caratteri UTF-8 in un valore.
public:
static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::SByte % result) = IUtf8SpanParsable<System::SByte>::TryParse;
public static bool TryParse (ReadOnlySpan<byte> utf8Text, IFormatProvider? provider, out sbyte result);
static member TryParse : ReadOnlySpan<byte> * IFormatProvider * sbyte -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider, ByRef result As SByte) As Boolean
Parametri
- utf8Text
- ReadOnlySpan<Byte>
Intervallo di caratteri UTF-8 da analizzare.
- provider
- IFormatProvider
Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura relative a utf8Text
.
- result
- SByte
In caso di restituzione, contiene il risultato dell'analisi utf8Text
corretta o di un valore non definito in caso di errore.
Restituisce
true
se utf8Text
è stato analizzato correttamente; in caso contrario, false
.
Si applica a
TryParse(ReadOnlySpan<Char>, SByte)
- Origine:
- SByte.cs
- Origine:
- SByte.cs
- Origine:
- SByte.cs
Importante
Questa API non è conforme a CLS.
Prova a convertire la rappresentazione intervallo di un numero nell'oggetto SByte equivalente e restituisce un valore che indica se la conversione è stata eseguita correttamente.
public:
static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] System::SByte % result);
public static bool TryParse (ReadOnlySpan<char> s, out sbyte result);
[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, out sbyte result);
static member TryParse : ReadOnlySpan<char> * sbyte -> bool
[<System.CLSCompliant(false)>]
static member TryParse : ReadOnlySpan<char> * sbyte -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As SByte) As Boolean
Parametri
- s
- ReadOnlySpan<Char>
Intervallo contenente i caratteri che rappresentano il numero da convertire.
- result
- SByte
Quando questo metodo viene restituito, contiene il valore intero con segno a 8 bit equivalente al numero contenuto in s
se la conversione riesce oppure zero se la conversione non riesce. La conversione ha esito negativo se il s
parametro è null
o Empty, non è nel formato corretto oppure rappresenta un numero minore di SByte.MinValue o maggiore di SByte.MaxValue. Questo parametro viene passato non inizializzato. Qualsiasi valore fornito in origine in result
verrà sovrascritto.
Restituisce
true
se s
è stato convertito correttamente; in caso contrario, false
.
- Attributi
Si applica a
TryParse(String, SByte)
- Origine:
- SByte.cs
- Origine:
- SByte.cs
- Origine:
- SByte.cs
Importante
Questa API non è conforme a CLS.
Prova a convertire la rappresentazione di stringa di un numero nell'oggetto SByte equivalente e restituisce un valore che indica se la conversione è stata eseguita correttamente.
public:
static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] System::SByte % result);
[System.CLSCompliant(false)]
public static bool TryParse (string s, out sbyte result);
public static bool TryParse (string? s, out sbyte result);
[System.CLSCompliant(false)]
public static bool TryParse (string? s, out sbyte result);
[<System.CLSCompliant(false)>]
static member TryParse : string * sbyte -> bool
static member TryParse : string * sbyte -> bool
Public Shared Function TryParse (s As String, ByRef result As SByte) As Boolean
Parametri
- s
- String
Stringa contenente un numero da convertire.
- result
- SByte
Quando questo metodo viene restituito, contiene il valore intero con segno a 8 bit equivalente al numero contenuto in s
se la conversione riesce oppure zero se la conversione non riesce. La conversione ha esito negativo se il s
parametro è null
o Empty, non è nel formato corretto oppure rappresenta un numero minore di SByte.MinValue o maggiore di SByte.MaxValue. Questo parametro viene passato non inizializzato. Qualsiasi valore fornito in origine in result
verrà sovrascritto.
Restituisce
true
se s
è stato convertito correttamente; in caso contrario, false
.
- Attributi
Esempio
L'esempio seguente tenta di convertire le stringhe in una matrice in SByte valori chiamando il TryParse(String, SByte) metodo .
string[] numericStrings = {"-3.6", "12.8", "+16.7", " 3 ", "(17)",
"-17", "+12", "18-", "987", "1,024", " 127 "};
sbyte number;
foreach (string numericString in numericStrings)
{
if (sbyte.TryParse(numericString, out number))
Console.WriteLine("Converted '{0}' to {1}.", numericString, number);
else
Console.WriteLine("Cannot convert '{0}' to an SByte.", numericString);
}
// The example displays the following output to the console:
// Cannot convert '-3.6' to an SByte.
// Cannot convert '12.8' to an SByte.
// Cannot convert '+16.7' to an SByte.
// Converted ' 3 ' to 3.
// Cannot convert '(17)' to an SByte.
// Converted '-17' to -17.
// Converted '+12' to 12.
// Cannot convert '18-' to an SByte.
// Cannot convert '987' to an SByte.
// Cannot convert '1,024' to an SByte.
// Converted ' 127 ' to 127.
open System
let numericStrings =
[| "-3.6"; "12.8"; "+16.7"; " 3 "; "(17)"
"-17"; "+12"; "18-"; "987"; "1,024"; " 127 " |]
for numericString in numericStrings do
match SByte.TryParse numericString with
| true, number ->
printfn $"Converted '{numericString}' to {number}."
| _ ->
printfn $"Cannot convert '{numericString}' to an SByte."
// The example displays the following output to the console:
// Cannot convert '-3.6' to an SByte.
// Cannot convert '12.8' to an SByte.
// Cannot convert '+16.7' to an SByte.
// Converted ' 3 ' to 3.
// Cannot convert '(17)' to an SByte.
// Converted '-17' to -17.
// Converted '+12' to 12.
// Cannot convert '18-' to an SByte.
// Cannot convert '987' to an SByte.
// Cannot convert '1,024' to an SByte.
// Converted ' 127 ' to 127.
Dim numericStrings() As String = {"-3.6", "12.8", "+16.7", " 3 ", _
"(17)", "-17", "+12", "18-", "987", _
"1,024", " 127 "}
Dim number As SByte
For Each numericString As String In numericStrings
If SByte.TryParse(numericString, number) Then
Console.WriteLine("Converted '{0}' to {1}.", numericString, number)
Else
Console.WriteLine("Cannot convert '{0}' to an SByte.", numericString)
End If
Next
' The example displays the following output to the console:
' Cannot convert '-3.6' to an SByte.
' Cannot convert '12.8' to an SByte.
' Cannot convert '+16.7' to an SByte.
' Converted ' 3 ' to 3.
' Cannot convert '(17)' to an SByte.
' Converted '-17' to -17.
' Converted '+12' to 12.
' Cannot convert '18-' to an SByte.
' Cannot convert '987' to an SByte.
' Cannot convert '1,024' to an SByte.
' Converted ' 127 ' to 127.
Commenti
Il SByte.TryParse(String, SByte) metodo è simile al SByte.Parse(String) metodo , ad eccezione del fatto che non genera un'eccezione se la conversione non riesce. Questo metodo elimina la necessità di usare la gestione delle eccezioni per verificare se un FormatExceptionvalue
oggetto non è valido e non può essere analizzato correttamente.
Il s
parametro deve essere la rappresentazione di stringa di un numero decimale nel formato seguente:
[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. |
sign | Segno facoltativo. I caratteri di segno validi sono determinati dalle NumberFormatInfo.NegativeSign proprietà e NumberFormatInfo.PositiveSign delle impostazioni cultura correnti. |
Cifre | Sequenza di cifre decimali comprese tra 0 e 9. |
Nota
La stringa specificata dal value
parametro non può contenere separatori di gruppo o separatori decimali e non può avere una parte decimale.
Il s
parametro viene interpretato usando lo NumberStyles.Integer stile . Oltre alle cifre decimali, sono consentiti solo spazi iniziali e finali con un segno iniziale. Per definire in modo esplicito gli elementi di stile con le informazioni di formattazione specifiche delle impostazioni cultura che possono essere presenti in value
, chiamare il TryParse(String, NumberStyles, IFormatProvider, SByte) metodo .
Il s
parametro viene analizzato usando le informazioni di formattazione in un NumberFormatInfo oggetto per le impostazioni cultura correnti. Per altre informazioni, vedere NumberFormatInfo.CurrentInfo.
Questo overload interpreta tutte le cifre nel value
parametro come cifre decimali. Per analizzare la rappresentazione di stringa di un numero esadecimale, chiamare invece l'overload TryParse(String, NumberStyles, IFormatProvider, SByte) .
Vedi anche
- Esempio: Utilità di formattazione di .NET Core WinForms (C#)
- Esempio: Utilità di formattazione di .NET Core WinForms (Visual Basic)
Si applica a
TryParse(ReadOnlySpan<Char>, IFormatProvider, SByte)
- Origine:
- SByte.cs
- Origine:
- SByte.cs
- Origine:
- SByte.cs
Tenta di analizzare un intervallo di caratteri in un valore.
public:
static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::SByte % result) = ISpanParsable<System::SByte>::TryParse;
public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider? provider, out sbyte result);
static member TryParse : ReadOnlySpan<char> * IFormatProvider * sbyte -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As SByte) As Boolean
Parametri
- s
- ReadOnlySpan<Char>
Intervallo di caratteri da analizzare.
- provider
- IFormatProvider
Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura relative a s
.
- result
- SByte
Quando termina, questo metodo contiene il risultato dell'analisi s
corretta di o di un valore non definito in caso di errore.
Restituisce
true
se s
è stato analizzato correttamente; in caso contrario, false
.
Si applica a
TryParse(String, IFormatProvider, SByte)
- Origine:
- SByte.cs
- Origine:
- SByte.cs
- Origine:
- SByte.cs
Tenta di analizzare una stringa in un valore.
public:
static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::SByte % result) = IParsable<System::SByte>::TryParse;
public static bool TryParse (string? s, IFormatProvider? provider, out sbyte result);
static member TryParse : string * IFormatProvider * sbyte -> bool
Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As SByte) As Boolean
Parametri
- s
- String
Stringa da analizzare.
- provider
- IFormatProvider
Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura relative a s
.
- result
- SByte
Quando termina, questo metodo contiene il risultato dell'analisi s
corretta o di un valore non definito in caso di errore.
Restituisce
true
se s
è stato analizzato correttamente; in caso contrario, false
.
Si applica a
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, SByte)
- Origine:
- SByte.cs
- Origine:
- SByte.cs
Tenta di analizzare un intervallo di caratteri UTF-8 in un valore.
public:
static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::SByte % result) = System::Numerics::INumberBase<System::SByte>::TryParse;
public static bool TryParse (ReadOnlySpan<byte> utf8Text, System.Globalization.NumberStyles style, IFormatProvider? provider, out sbyte result);
static member TryParse : ReadOnlySpan<byte> * System.Globalization.NumberStyles * IFormatProvider * sbyte -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), style As NumberStyles, provider As IFormatProvider, ByRef result As SByte) As Boolean
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 relative a utf8Text
.
- result
- SByte
In caso di restituzione, contiene il risultato dell'analisi utf8Text
corretta o di un valore non definito in caso di errore.
Restituisce
true
se utf8Text
è stato analizzato correttamente; in caso contrario, false
.
Si applica a
TryParse(ReadOnlySpan<Byte>, SByte)
- Origine:
- SByte.cs
- Origine:
- SByte.cs
Tenta di convertire un intervallo di caratteri UTF-8 contenente la rappresentazione di stringa di un numero nell'equivalente intero con segno a 8 bit.
public:
static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, [Runtime::InteropServices::Out] System::SByte % result);
public static bool TryParse (ReadOnlySpan<byte> utf8Text, out sbyte result);
static member TryParse : ReadOnlySpan<byte> * sbyte -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), ByRef result As SByte) As Boolean
Parametri
- utf8Text
- ReadOnlySpan<Byte>
Intervallo contenente i caratteri UTF-8 che rappresentano il numero da convertire.
- result
- SByte
Quando termina, questo metodo contiene il valore intero con segno a 8 bit equivalente al numero contenuto in utf8Text
se la conversione ha avuto esito positivo oppure zero se la conversione non è riuscita. Questo parametro viene passato non inizializzato. Qualsiasi valore specificato in origine in result verrà sovrascritto.
Restituisce
true
se utf8Text
è stato convertito correttamente; in caso contrario, false
.
Si applica a
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, SByte)
- Origine:
- SByte.cs
- Origine:
- SByte.cs
- Origine:
- SByte.cs
Importante
Questa API non è conforme a CLS.
Prova a convertire la rappresentazione intervallo di un numero in uno stile specificato e un formato specifico delle impostazioni cultura indicato nel valore SByte equivalente e restituisce un valore che indica se la conversione è stata eseguita correttamente.
public:
static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::SByte % result);
public:
static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::SByte % result) = System::Numerics::INumberBase<System::SByte>::TryParse;
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out sbyte result);
[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider provider, out sbyte result);
[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out sbyte result);
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * sbyte -> bool
[<System.CLSCompliant(false)>]
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * sbyte -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As SByte) As Boolean
Parametri
- s
- ReadOnlySpan<Char>
Intervallo contenente i caratteri che rappresentano il numero da convertire.
- style
- NumberStyles
Combinazione bit per bit di valori di enumerazione che indica il formato consentito di s
. Un valore tipico da specificare è Integer.
- provider
- IFormatProvider
Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura relativamente a s
.
- result
- SByte
Quando questo metodo viene restituito, contiene l'intero con segno a 8 bit equivalente al numero contenuto in s
, se la conversione riesce oppure zero se la conversione non riesce. La conversione ha esito negativo se il s
parametro è null
o Empty, non è conforme a style
o rappresenta un numero minore di SByte.MinValue o maggiore di SByte.MaxValue. Questo parametro viene passato non inizializzato. Qualsiasi valore fornito in origine in result
verrà sovrascritto.
Restituisce
true
se s
è stato convertito correttamente; in caso contrario, false
.
- Attributi
Si applica a
TryParse(String, NumberStyles, IFormatProvider, SByte)
- Origine:
- SByte.cs
- Origine:
- SByte.cs
- Origine:
- SByte.cs
Importante
Questa API non è conforme a CLS.
- Alternativa conforme a CLS
- System.Int16.TryParse(String, Int16)
Prova a convertire la rappresentazione di stringa di un numero in uno stile specificato e un formato specifico delle impostazioni cultura indicato nell'oggetto SByte equivalente e restituisce un valore che indica se la conversione è stata eseguita correttamente.
public:
static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::SByte % result);
public:
static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::SByte % result) = System::Numerics::INumberBase<System::SByte>::TryParse;
[System.CLSCompliant(false)]
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out sbyte result);
public static bool TryParse (string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out sbyte result);
[System.CLSCompliant(false)]
public static bool TryParse (string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out sbyte result);
[<System.CLSCompliant(false)>]
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * sbyte -> bool
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * sbyte -> bool
Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As SByte) As Boolean
Parametri
- s
- String
Stringa che rappresenta un numero da convertire.
- style
- NumberStyles
Combinazione bit per bit di valori di enumerazione che indica il formato consentito di s
. Un valore tipico da specificare è Integer.
- provider
- IFormatProvider
Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura relativamente a s
.
- result
- SByte
Quando questo metodo viene restituito, contiene l'intero con segno a 8 bit equivalente al numero contenuto in s
, se la conversione riesce oppure zero se la conversione non riesce. La conversione ha esito negativo se il s
parametro è o Empty, non è null
conforme a style
o rappresenta un numero minore di SByte.MinValue o maggiore di SByte.MaxValue. Questo parametro viene passato non inizializzato. Qualsiasi valore fornito in origine in result
verrà sovrascritto.
Restituisce
true
se s
è stato convertito correttamente; in caso contrario, false
.
- Attributi
Eccezioni
style
non è un valore di NumberStyles.
-oppure-
style
non è una combinazione di valori di AllowHexSpecifier e HexNumber.
Esempio
Nell'esempio seguente viene chiamato il TryParse(String, NumberStyles, IFormatProvider, SByte) metodo con un numero di stringhe e NumberStyles valori diversi.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
string numericString;
NumberStyles styles;
numericString = "106";
styles = NumberStyles.Integer;
CallTryParse(numericString, styles);
numericString = "-106";
styles = NumberStyles.None;
CallTryParse(numericString, styles);
numericString = "103.00";
styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
CallTryParse(numericString, styles);
numericString = "103.72";
styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
CallTryParse(numericString, styles);
numericString = "10E-01";
styles = NumberStyles.Integer | NumberStyles.AllowExponent;
CallTryParse(numericString, styles);
numericString = "12E-01";
CallTryParse(numericString, styles);
numericString = "12E01";
CallTryParse(numericString, styles);
numericString = "C8";
CallTryParse(numericString, NumberStyles.HexNumber);
numericString = "0x8C";
CallTryParse(numericString, NumberStyles.HexNumber);
}
private static void CallTryParse(string stringToConvert, NumberStyles styles)
{
sbyte number;
bool result = SByte.TryParse(stringToConvert, styles,
CultureInfo.InvariantCulture, out number);
if (result)
Console.WriteLine($"Converted '{stringToConvert}' to {number}.");
else
Console.WriteLine($"Attempted conversion of '{stringToConvert}' failed.");
}
}
// The example displays the following output:
// Converted '106' to 106.
// Attempted conversion of '-106' failed.
// Converted '103.00' to 103.
// Attempted conversion of '103.72' failed.
// Converted '10E-01' to 1.
// Attempted conversion of '12E-01' failed.
// Converted '12E01' to 120.
// Converted 'C8' to -56.
// Attempted conversion of '0x8C' failed.
open System
open System.Globalization
let callTryParse (stringToConvert: string) styles =
match SByte.TryParse(stringToConvert, styles, CultureInfo.InvariantCulture) with
| true, number ->
printfn $"Converted '{stringToConvert}' to {number}."
| _ ->
printfn $"Attempted conversion of '{stringToConvert}' failed."
[<EntryPoint>]
let main _ =
let numericString = "106"
let styles = NumberStyles.Integer
callTryParse numericString styles
let numericString = "-106"
let styles = NumberStyles.None
callTryParse numericString styles
let numericString = "103.00"
let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
callTryParse numericString styles
let numericString = "103.72"
let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
callTryParse numericString styles
let numericString = "10E-01"
let styles = NumberStyles.Integer ||| NumberStyles.AllowExponent
callTryParse numericString styles
let numericString = "12E-01"
callTryParse numericString styles
let numericString = "12E01"
callTryParse numericString styles
let numericString = "C8"
callTryParse numericString NumberStyles.HexNumber
let numericString = "0x8C"
callTryParse numericString NumberStyles.HexNumber
0
// The example displays the following output:
// Converted '106' to 106.
// Attempted conversion of '-106' failed.
// Converted '103.00' to 103.
// Attempted conversion of '103.72' failed.
// Converted '10E-01' to 1.
// Attempted conversion of '12E-01' failed.
// Converted '12E01' to 120.
// Converted 'C8' to -56.
// Attempted conversion of '0x8C' failed.
Imports System.Globalization
Module StringParsing
Public Sub Main()
Dim numericString As String
Dim styles As NumberStyles
numericString = "106"
styles = NumberStyles.Integer
CallTryParse(numericString, styles)
numericString = "-106"
styles = NumberStyles.None
CallTryParse(numericString, styles)
numericString = "103.00"
styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
CallTryParse(numericString, styles)
numericString = "103.72"
styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
CallTryParse(numericString, styles)
numericString = "10E-01"
styles = NumberStyles.Integer Or NumberStyles.AllowExponent
CallTryParse(numericString, styles)
numericString = "12E-01"
CallTryParse(numericString, styles)
numericString = "12E01"
CallTryParse(numericString, styles)
numericString = "C8"
CallTryParse(numericString, NumberStyles.HexNumber)
numericString = "0x8C"
CallTryParse(numericString, NumberStyles.HexNumber)
End Sub
Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
Dim number As SByte
Dim result As Boolean = SByte.TryParse(stringToConvert, styles, _
CultureInfo.InvariantCulture, number)
If result Then
Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number)
Else
Console.WriteLine("Attempted conversion of '{0}' failed.", _
Convert.ToString(stringToConvert))
End If
End Sub
End Module
' The example displays the following output to the console:
' Converted '106' to 106.
' Attempted conversion of '-106' failed.
' Converted '103.00' to 103.
' Attempted conversion of '103.72' failed.
' Converted '10E-01' to 1.
' Attempted conversion of '12E-01' failed.
' Converted '12E01' to 120.
' Converted 'C8' to -56.
' Attempted conversion of '0x8C' failed.
Commenti
Il TryParse(String, NumberStyles, IFormatProvider, SByte) metodo è simile al metodo, ad eccezione del fatto che non genera un'eccezione Parse(String, NumberStyles, IFormatProvider) se la conversione ha esito negativo. Questo metodo elimina la necessità di usare la gestione delle eccezioni per testare un FormatException oggetto se value
non è valido e non può essere analizzato correttamente.
Il style
parametro definisce gli elementi di stile , ad esempio spazio vuoto o segno positivo o negativo, consentiti nel value
parametro per l'operazione di analisi. Deve essere una combinazione di flag di bit dall'enumerazione NumberStyles . A seconda del valore di style
, il value
parametro può includere gli elementi seguenti:
[ws] [$][sign][digits,]digits[.fractional_digits][E[sign]exponential_digits][ws]
Se il parametro include AllowHexSpecifier, il value
style
parametro può includere gli elementi seguenti:
[ws] hexdigits[ws]
Gli elementi tra parentesi quadre ([e]) sono facoltativi. La tabella seguente descrive i singoli elementi.
Elemento | Descrizione |
---|---|
ws | Spazio vuoto facoltativo. Lo spazio vuoto può essere visualizzato all'inizio di value se include il NumberStyles.AllowLeadingWhite flag o alla fine di value se style include il NumberStyles.AllowTrailingWhite flag.style |
$ | Simbolo di valuta specifico delle impostazioni cultura. La sua posizione nella stringa è definita dalla CurrencyPositivePattern proprietà dell'oggetto NumberFormatInfo restituito dal GetFormat metodo del provider parametro. Il simbolo di valuta può essere visualizzato in value se style include il NumberStyles.AllowCurrencySymbol flag. |
sign | Segno facoltativo. Il segno può essere visualizzato all'inizio di value se include il NumberStyles.AllowLeadingSign flag e può essere visualizzato alla fine di value se style include il NumberStyles.AllowTrailingSignstyle flag. Le parentesi possono essere usate in value per indicare un valore negativo se style include il NumberStyles.AllowParentheses flag. |
Cifre | Sequenza di cifre da 0 a 9. |
, | Separatore di gruppo specifico delle impostazioni cultura. Il separatore di gruppo delle impostazioni cultura specificate da provider può essere visualizzato in value se style include il NumberStyles.AllowThousands flag. |
. | Simbolo decimale specifico delle impostazioni cultura. Il simbolo decimale delle impostazioni cultura specificate da provider può essere visualizzato in value se style include il NumberStyles.AllowDecimalPoint flag. |
Cifre_frazionarie | Una o più occorrenze della cifra 0. Le cifre frazionarie possono essere visualizzate solo value se style include il NumberStyles.AllowDecimalPoint flag. |
E | Carattere "e" o "E", che indica che il valore è rappresentato nella notazione esponenziale (scientifica). Il value parametro può rappresentare un numero in notazione esponenziale se style include il NumberStyles.AllowExponent flag. |
exponential_digits | Sequenza di cifre da 0 a 9. Il value 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. |
Nota
Tutti i caratteri NUL terminanti (U+0000) vengono s
ignorati dall'operazione di analisi, indipendentemente dal valore dell'argomento style
.
Una stringa con cifre decimali (che corrisponde al NumberStyles.None flag) analizza sempre correttamente. La maggior parte degli elementi di controllo dei membri rimanenti NumberStyles che possono essere presenti, ma non sono necessari, in questa stringa di input. La tabella seguente indica come i singoli NumberStyles membri influiscono sugli elementi che possono essere presenti in value
.
Valori non compositi NumberStyles |
Elementi consentiti in valore oltre alle cifre |
---|---|
None | Solo cifre decimali. |
AllowDecimalPoint | Elemento decimale (.) e fractional_digits . Tuttavia, fractional_digits deve essere costituito da una o più cifre oppure il metodo restituisce false . |
AllowExponent | Carattere "e" o "E", che indica la notazione esponenziale, insieme a exponential_digits. Se value rappresenta un numero in notazione esponenziale, non può avere un componente frazionaria diverso da zero. |
AllowLeadingWhite | Elemento ws all'inizio di value . |
AllowTrailingWhite | Elemento ws alla fine di value . |
AllowLeadingSign | Elemento di firma prima delle cifre. |
AllowTrailingSign | Elemento di segno dopo le cifre. |
AllowParentheses | Elemento di segno sotto forma di parentesi che racchiude il valore numerico. |
AllowThousands | Elemento separatore di gruppo (,). |
AllowCurrencySymbol | Elemento currency ($). |
Currency | Tutti gli elementi. Tuttavia, value non può rappresentare un numero esadecimale o un numero in notazione esponenziale. |
Float | Elemento ws all'inizio o alla fine di value , segno all'inizio di value e il simbolo decimale (.). Il value parametro può anche usare la notazione esponenziale. |
Number | Elementi ws, sign, group separator (,) e decimale (.). |
Any | Tutti gli elementi. Tuttavia, value non può rappresentare un numero esadecimale. |
Se viene usato il NumberStyles.AllowHexSpecifier flag, value
deve essere un valore esadecimale. Le cifre esadecimali valide sono 0-9, a-f e A-F. Gli unici flag che possono essere presenti in style
sono NumberStyles.AllowLeadingWhite e NumberStyles.AllowTrailingWhite. L'enumerazione NumberStyles ha uno stile composito, , HexNumberche include entrambi i flag di spazi vuoti.
Nota
Se value
è la rappresentazione stringa di un numero esadecimale, non può essere preceduta da alcuna decorazione (ad esempio 0x
o &h
) che la differenzia come numero esadecimale. In questo modo la conversione ha esito negativo.
Il provider
parametro è un'implementazione IFormatProvider . Il GetFormat metodo restituisce un NumberFormatInfo oggetto che fornisce informazioni specifiche delle impostazioni cultura sul formato di value
. Il provider
parametro può essere uno dei seguenti:
Oggetto CultureInfo che rappresenta le impostazioni cultura che forniscono informazioni di formattazione. Il GetFormat metodo restituisce l'oggetto NumberFormatInfo che fornisce informazioni di formattazione numerica per tali impostazioni cultura.
Oggetto NumberFormatInfo che fornisce informazioni di formattazione numerica. (L'implementazione di GetFormat è stata appena restituita).
Oggetto personalizzato che implementa IFormatProvider. Il GetFormat metodo crea un'istanza e restituisce l'oggetto NumberFormatInfo che fornisce informazioni di formattazione.
Se provider
è null
, viene usato l'oggetto NumberFormatInfo per le impostazioni cultura correnti.
Vedi anche
Si applica a
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per