SByte.TryParse Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Converte a representação da cadeia de caracteres de um número no inteiro assinado de 8 dígitos equivalente. Um código de retorno indica se a conversão foi bem-sucedida ou falhou.
Sobrecargas
TryParse(ReadOnlySpan<Byte>, IFormatProvider, SByte) |
Tenta analisar um intervalo de caracteres UTF-8 em um valor. |
TryParse(ReadOnlySpan<Char>, SByte) |
Tenta converter a representação de intervalo de um número em seu SByte equivalente e retorna um valor que indica se a conversão foi bem-sucedida. |
TryParse(String, SByte) |
Tenta converter a representação de cadeia de caracteres de um número em seu SByte equivalente e retorna um valor que indica se a conversão foi bem-sucedida. |
TryParse(ReadOnlySpan<Char>, IFormatProvider, SByte) |
Tenta analisar um intervalo de caracteres em um valor. |
TryParse(String, IFormatProvider, SByte) |
Tenta analisar uma cadeia de caracteres em um valor. |
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, SByte) |
Tenta analisar um intervalo de caracteres UTF-8 em um valor. |
TryParse(ReadOnlySpan<Byte>, SByte) |
Tenta converter um intervalo de caracteres UTF-8 que contém a representação de cadeia de caracteres de um número em seu inteiro com sinal de 8 bits equivalente. |
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, SByte) |
Tenta converter a representação de intervalo de um número em um formato específico da cultura e um estilo especificados em seu equivalente de SByte e retorna um valor que indica se a conversão foi bem-sucedida. |
TryParse(String, NumberStyles, IFormatProvider, SByte) |
Tenta converter a representação de cadeia de caracteres de um número em um estilo e formato específico à cultura especificados no equivalente SByte e retorna um valor que indica se a conversão foi bem-sucedida. |
TryParse(ReadOnlySpan<Byte>, IFormatProvider, SByte)
- Origem:
- SByte.cs
- Origem:
- SByte.cs
Tenta analisar um intervalo de caracteres UTF-8 em um valor.
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
Parâmetros
- utf8Text
- ReadOnlySpan<Byte>
O intervalo de caracteres UTF-8 a serem analisados.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas à cultura sobre utf8Text
.
- result
- SByte
No retorno, contém o resultado da análise utf8Text
com êxito ou de um valor indefinido em caso de falha.
Retornos
true
se utf8Text
tiver sido analisado com êxito; caso contrário, false
.
Aplica-se a
TryParse(ReadOnlySpan<Char>, SByte)
- Origem:
- SByte.cs
- Origem:
- SByte.cs
- Origem:
- SByte.cs
Importante
Esta API não está em conformidade com CLS.
Tenta converter a representação de intervalo de um número em seu SByte equivalente e retorna um valor que indica se a conversão foi bem-sucedida.
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
Parâmetros
- s
- ReadOnlySpan<Char>
Um intervalo que contém os caracteres que representam o número a ser convertido.
- result
- SByte
Quando for retornado, esse método conterá o valor inteiro com sinal de 8 bits equivalente ao número contido em s
se a conversão tiver sido bem-sucedida, ou zero se a conversão tiver falhado. A conversão falhará se o s
parâmetro for null
ou Empty, não estiver no formato correto ou representar um número menor que SByte.MinValue ou maior que SByte.MaxValue. Este parâmetro é passado não inicializado; qualquer valor fornecido originalmente em result
será substituído.
Retornos
true
caso s
tenha sido convertido com êxito; do contrário, false
.
- Atributos
Aplica-se a
TryParse(String, SByte)
- Origem:
- SByte.cs
- Origem:
- SByte.cs
- Origem:
- SByte.cs
Importante
Esta API não está em conformidade com CLS.
Tenta converter a representação de cadeia de caracteres de um número em seu SByte equivalente e retorna um valor que indica se a conversão foi bem-sucedida.
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
Parâmetros
- s
- String
Uma cadeia de caracteres que contém um número a ser convertido.
- result
- SByte
Quando for retornado, esse método conterá o valor inteiro com sinal de 8 bits equivalente ao número contido em s
se a conversão tiver sido bem-sucedida, ou zero se a conversão tiver falhado. A conversão falhará se o s
parâmetro for null
ou Empty, não estiver no formato correto ou representar um número menor que SByte.MinValue ou maior que SByte.MaxValue. Este parâmetro é passado não inicializado; qualquer valor fornecido originalmente em result
será substituído.
Retornos
true
caso s
tenha sido convertido com êxito; do contrário, false
.
- Atributos
Exemplos
O exemplo a seguir tenta converter as cadeias de caracteres em uma matriz SByte em valores chamando o TryParse(String, SByte) método .
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.
Comentários
O SByte.TryParse(String, SByte) método é semelhante ao SByte.Parse(String) método , exceto que ele não gera uma exceção se a conversão falhar. Esse método elimina a necessidade de usar o tratamento de exceção para testar um FormatException se value
é inválido e não pode ser analisado com êxito.
O parâmetro s
deve ser a representação da cadeia de caracteres de um número decimal na seguinte forma:
[ws] [sign] digits[ws]
Os elementos entre colchetes ([ e ]) são opcionais. A tabela a seguir descreve cada elemento.
Elemento | Descrição |
---|---|
ws | Espaço em branco opcional. |
sign | Um sinal opcional. Os caracteres de sinal válido são determinados pelas propriedades NumberFormatInfo.NegativeSign e NumberFormatInfo.PositiveSign da cultura atual. |
dígitos | Uma sequência de dígitos decimais que varia de 0 a 9. |
Observação
A cadeia de caracteres especificada pelo value
parâmetro não pode conter separadores de grupo ou separador decimal e não pode ter uma parte decimal.
O parâmetro s
é interpretado usando-se o estilo NumberStyles.Integer. Além dos dígitos decimais, apenas os espaço à esquerda e à direita com um sinal à esquerda são permitidos. Para definir explicitamente os elementos de estilo com as informações de formatação específicas da cultura que podem estar presentes no value
, chame o TryParse(String, NumberStyles, IFormatProvider, SByte) método .
O s
parâmetro é analisado usando as informações de formatação em um NumberFormatInfo objeto para a cultura atual. Para obter mais informações, consulte NumberFormatInfo.CurrentInfo.
Essa sobrecarga interpreta todos os dígitos no value
parâmetro como dígitos decimais. Para analisar a representação de cadeia de caracteres de um número hexadecimal, chame a TryParse(String, NumberStyles, IFormatProvider, SByte) sobrecarga.
Confira também
- Amostra: Utilitário de Formatação do WinForms do .NET Core (C#)
- Amostra: Utilitário de Formatação do WinForms do .NET Core (Visual Basic)
Aplica-se a
TryParse(ReadOnlySpan<Char>, IFormatProvider, SByte)
- Origem:
- SByte.cs
- Origem:
- SByte.cs
- Origem:
- SByte.cs
Tenta analisar um intervalo de caracteres em um valor.
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
Parâmetros
- s
- ReadOnlySpan<Char>
O intervalo de caracteres a serem analisados.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas à cultura sobre s
.
- result
- SByte
Quando esse método retorna, contém o resultado da análise s
com êxito ou um valor indefinido sobre a falha.
Retornos
true
se s
tiver sido analisado com êxito; caso contrário, false
.
Aplica-se a
TryParse(String, IFormatProvider, SByte)
- Origem:
- SByte.cs
- Origem:
- SByte.cs
- Origem:
- SByte.cs
Tenta analisar uma cadeia de caracteres em um valor.
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
Parâmetros
- s
- String
A cadeia de caracteres a ser analisada.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas à cultura sobre s
.
- result
- SByte
Quando esse método retorna, contém o resultado da análise s
com êxito ou um valor indefinido em caso de falha.
Retornos
true
se s
tiver sido analisado com êxito; caso contrário, false
.
Aplica-se a
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, SByte)
- Origem:
- SByte.cs
- Origem:
- SByte.cs
Tenta analisar um intervalo de caracteres UTF-8 em um valor.
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
Parâmetros
- utf8Text
- ReadOnlySpan<Byte>
O intervalo de caracteres UTF-8 a serem analisados.
- style
- NumberStyles
Uma combinação bit a bit de estilos numéricos que podem estar presentes em utf8Text
.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas à cultura sobre utf8Text
.
- result
- SByte
No retorno, contém o resultado da análise utf8Text
com êxito ou de um valor indefinido em caso de falha.
Retornos
true
se utf8Text
tiver sido analisado com êxito; caso contrário, false
.
Aplica-se a
TryParse(ReadOnlySpan<Byte>, SByte)
- Origem:
- SByte.cs
- Origem:
- SByte.cs
Tenta converter um intervalo de caracteres UTF-8 que contém a representação de cadeia de caracteres de um número em seu inteiro com sinal de 8 bits equivalente.
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
Parâmetros
- utf8Text
- ReadOnlySpan<Byte>
Um intervalo que contém os caracteres UTF-8 que representam o número a ser convertido.
- result
- SByte
Quando esse método retorna, contém o valor inteiro com sinal de 8 bits equivalente ao número contido em utf8Text
se a conversão foi bem-sucedida ou zero se a conversão falhou. Este parâmetro é passado não inicializado; qualquer valor fornecido originalmente no resultado será substituído.
Retornos
true
caso utf8Text
tenha sido convertido com êxito; do contrário, false
.
Aplica-se a
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, SByte)
- Origem:
- SByte.cs
- Origem:
- SByte.cs
- Origem:
- SByte.cs
Importante
Esta API não está em conformidade com CLS.
Tenta converter a representação de intervalo de um número em um formato específico da cultura e um estilo especificados em seu equivalente de SByte e retorna um valor que indica se a conversão foi bem-sucedida.
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
Parâmetros
- s
- ReadOnlySpan<Char>
Um intervalo que contém os caracteres que representam o número a ser convertido.
- style
- NumberStyles
Um combinação bit a bit de valores de enumeração que indica o formato permitido de s
. Um valor típico a ser especificado é Integer.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas da cultura sobre s
.
- result
- SByte
Quando esse método for retornado, conterá o equivalente do valor inteiro com sinal de 8 bits do número contido em s
se a conversão tiver sido bem-sucedida ou zero se a conversão tiver falhado. A conversão falhará se o s
parâmetro for null
ou Empty, não estiver em um formato compatível com style
ou representar um número menor que SByte.MinValue ou maior que SByte.MaxValue. Este parâmetro é passado não inicializado; qualquer valor fornecido originalmente em result
será substituído.
Retornos
true
caso s
tenha sido convertido com êxito; do contrário, false
.
- Atributos
Aplica-se a
TryParse(String, NumberStyles, IFormatProvider, SByte)
- Origem:
- SByte.cs
- Origem:
- SByte.cs
- Origem:
- SByte.cs
Importante
Esta API não está em conformidade com CLS.
- Alternativa em conformidade com CLS
- System.Int16.TryParse(String, Int16)
Tenta converter a representação de cadeia de caracteres de um número em um estilo e formato específico à cultura especificados no equivalente SByte e retorna um valor que indica se a conversão foi bem-sucedida.
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
Parâmetros
- s
- String
Uma cadeia de caracteres que representa um número a ser convertido.
- style
- NumberStyles
Um combinação bit a bit de valores de enumeração que indica o formato permitido de s
. Um valor típico a ser especificado é Integer.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas da cultura sobre s
.
- result
- SByte
Quando esse método for retornado, conterá o equivalente do valor inteiro com sinal de 8 bits do número contido em s
se a conversão tiver sido bem-sucedida ou zero se a conversão tiver falhado. A conversão falhará se o s
parâmetro for null
ou Empty, não estiver em um formato compatível com style
ou representar um número menor que SByte.MinValue ou maior que SByte.MaxValue. Este parâmetro é passado não inicializado; qualquer valor fornecido originalmente em result
será substituído.
Retornos
true
caso s
tenha sido convertido com êxito; do contrário, false
.
- Atributos
Exceções
style
não é um valor NumberStyles.
- ou -
style
não é uma combinação de valores AllowHexSpecifier e HexNumber.
Exemplos
O exemplo a seguir chama o TryParse(String, NumberStyles, IFormatProvider, SByte) método com várias cadeias de caracteres e NumberStyles valores diferentes.
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.
Comentários
O TryParse(String, NumberStyles, IFormatProvider, SByte) método é semelhante ao Parse(String, NumberStyles, IFormatProvider) método , exceto que ele não gera uma exceção se a conversão falhar. Esse método elimina a necessidade de usar o tratamento de exceção para testar um FormatException se value
é inválido e não pode ser analisado com êxito.
O parâmetro style
define os elementos de estilo (como o espaço em branco ou um sinal positivo ou negativo) que são permitidos no parâmetro value
para que a operação de análise seja bem-sucedida. Ele deve ser uma combinação de sinalizadores de bits da enumeração NumberStyles. Dependendo do valor de style
, o parâmetro value
pode incluir os seguintes elementos:
[ws] [$][sign][digits,]digits[.fractional_digits][E[sign]exponential_digits][ws]
Se o style
parâmetro incluir AllowHexSpecifier, o value
parâmetro poderá incluir os seguintes elementos:
[ws] hexdigits[ws]
Os elementos entre colchetes ([ e ]) são opcionais. A tabela a seguir descreve cada elemento.
Elemento | Descrição |
---|---|
ws | Espaço em branco opcional. O espaço em branco pode aparecer no início de value se incluir o NumberStyles.AllowLeadingWhite sinalizador ou no final de value se style incluir o NumberStyles.AllowTrailingWhite sinalizador.style |
$ | Um símbolo de moeda específico de cultura. A posição na cadeia de caracteres é definida pela propriedade CurrencyPositivePattern do objeto NumberFormatInfo retornado pelo método GetFormat do parâmetro provider . O símbolo de moeda pode ser exibido em value caso style inclua o sinalizador NumberStyles.AllowCurrencySymbol. |
sign | Um sinal opcional. O sinal pode ser exibido no início de value caso style inclua o sinalizador NumberStyles.AllowLeadingSign e ele pode ser exibido no final de value caso style inclua o sinalizador NumberStyles.AllowTrailingSign. Os parênteses podem ser usados em value para indicar um valor negativo caso style inclua o sinalizador NumberStyles.AllowParentheses. |
dígitos | Uma sequência de dígitos de 0 a 9. |
, | Um separador de grupo específico de cultura. O separador de grupo da cultura especificada por provider poderá aparecer em value se style incluir o NumberStyles.AllowThousands sinalizador. |
. | Um símbolo de vírgula decimal específico de cultura. O símbolo da vírgula decimal da cultura especificada por provider pode ser exibido em value caso style inclua o sinalizador NumberStyles.AllowDecimalPoint. |
Fractional_digits | Uma ou mais ocorrências de dígito 0. Os dígitos fracionários só podem ser exibidos em value caso style inclua o sinalizador NumberStyles.AllowDecimalPoint. |
E | O caractere "e" ou "E", que indica que o valor é representado em notação exponencial (científica). O parâmetro value pode representar um número em notação exponencial caso style inclua o sinalizador NumberStyles.AllowExponent. |
exponential_digits | Uma sequência de dígitos de 0 a 9. O parâmetro value pode representar um número em notação exponencial caso style inclua o sinalizador NumberStyles.AllowExponent. |
hexdigits | Uma sequência de dígitos hexadecimais de 0 a f ou de 0 a F. |
Observação
Todos os caracteres NUL de terminação (U+0000) no s
são ignorados pela operação de análise, independentemente do valor do style
argumento.
Uma cadeia de caracteres apenas com dígitos decimais (que corresponde ao sinalizador NumberStyles.None ) sempre é analisada com êxito. A maioria dos elementos de controle de membros NumberStyles restantes que podem estar presentes, mas que não precisam estar presentes, na cadeia de caracteres de entrada. A tabela a seguir indica como os membros NumberStyles individuais afetam os elementos que podem estar presentes em value
.
Valores NumberStyles não compostos |
Elementos permitidos no valor além de dígitos |
---|---|
None | Somente dígitos decimais. |
AllowDecimalPoint | O ponto decimal (.) e fractional_digits elementos. No entanto, fractional_digits deve consistir em apenas um ou mais 0 dígitos ou o método retorna false . |
AllowExponent | O caractere "e" ou "E", que indica notação exponencial, juntamente com exponential_digits. Se value representar um número na notação exponencial, ele não poderá ter um componente fracionário diferente de zero. |
AllowLeadingWhite | O elemento ws no início de value . |
AllowTrailingWhite | O elemento ws no final de value . |
AllowLeadingSign | O elemento sign antes dos dígitos. |
AllowTrailingSign | O elemento sign após dígitos. |
AllowParentheses | O elemento sinal na forma de parênteses que incluem o valor numérico. |
AllowThousands | O elemento separador de grupo (,). |
AllowCurrencySymbol | O elemento currency ($). |
Currency | Todos os elementos. No entanto, value não pode representar um número hexadecimal ou um número em notação exponencial. |
Float | O elemento ws no início ou no final de value , sinal no início de value e o símbolo de ponto decimal (.). O parâmetro value também pode usar notação exponencial. |
Number | Os elementos ws, sign, separador de grupo (,) e ponto decimal (.). |
Any | Todos os elementos. No entanto, value não pode representar um número hexadecimal. |
Caso o sinalizador NumberStyles.AllowHexSpecifier seja usado, value
deve ser um valor hexadecimal. Os dígitos hexadecimal válidos são 0-9, a-f e A-F. Os únicos outros sinalizadores que podem estar presentes em style
são NumberStyles.AllowLeadingWhite e NumberStyles.AllowTrailingWhite. (A enumeração NumberStyles tem um estilo composto, HexNumber, que inclui ambos os sinalizadores de espaço em branco.)
Observação
Caso value
seja a representação da cadeia de caracteres de um número hexadecimal, ele não pode ser precedido por qualquer decoração (como 0x
ou &h
) que o diferencia como um número hexadecimal. Isso faz a conversão falhar.
O parâmetro provider
é uma implementação de IFormatProvider. O método GetFormat retorna um objeto NumberFormatInfo que fornece informações específicas de cultura sobre o formato de value
. O parâmetro provider
pode ser qualquer um dos seguintes:
Um objeto CultureInfo que representa a cultura que fornece informações de formatação. O método GetFormat retorna o objeto NumberFormatInfo que fornece informações de formatação numérica para essa cultura.
Um objeto NumberFormatInfo que fornece informações de formatação numérica. (Sua implementação de GetFormat retorna apenas ele próprio.)
Um objeto personalizado que implementa IFormatProvider. O método GetFormat cria uma instância e retorna o objeto NumberFormatInfo que fornece informações de formatação.
Caso provider
seja null
, o objeto NumberFormatInfo da cultura atual é usado.
Confira também
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de