Compartilhar via


SByte.TryParse Método

Definição

Converte a representação de cadeia de caracteres de um número em seu equivalente inteiro com sinal de 8 bits. 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 equivalente inteiro com sinal de 8 bits.

TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, SByte)

Tenta converter a representação de intervalo de um número em um formato específico de estilo e cultura especificado em seu SByte equivalente 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 formato específico de cultura e estilo especificado em seu SByte equivalente 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 da cultura sobre utf8Text.

result
SByte

No retorno, contém o resultado da análise bem-sucedida de utf8Text ou de um valor indefinido sobre a falha.

Retornos

true se utf8Text foi 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 esse método é retornado, contém o valor inteiro com sinal de 8 bits equivalente ao número contido em s se a conversão foi bem-sucedida ou zero se a conversão falhou. A conversão falhará se o parâmetro s for null ou Empty, não estiver no formato correto ou representar um número menor que SByte.MinValue ou maior que SByte.MaxValue. Esse parâmetro é passado sem inicialização; qualquer valor originalmente fornecido em result será substituído.

Retornos

true se s foi convertido com êxito; caso 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 esse método é retornado, contém o valor inteiro com sinal de 8 bits equivalente ao número contido em s se a conversão foi bem-sucedida ou zero se a conversão falhou. A conversão falhará se o parâmetro s for null ou Empty, não estiver no formato correto ou representar um número menor que SByte.MinValue ou maior que SByte.MaxValue. Esse parâmetro é passado sem inicialização; qualquer valor originalmente fornecido em result será substituído.

Retornos

true se s foi convertido com êxito; caso contrário, false.

Atributos

Exemplos

O exemplo a seguir tenta converter as cadeias de caracteres em uma matriz para SByte valores chamando o método TryParse(String, SByte).

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 método SByte.TryParse(String, SByte) é como o método SByte.Parse(String), 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ções para testar um FormatException se value for inválido e não puder ser analisado com êxito.

O parâmetro s deve ser a representação de cadeia de caracteres de um número decimal no seguinte formulário:

[ws] [assinar]dígitos[ws]

Elementos em colchetes ([ e ]) são opcionais. A tabela a seguir descreve cada elemento.

Elemento Descrição
ws Espaço em branco opcional.
assinar Um sinal opcional. Caracteres de sinal válidos são determinados pelas propriedades NumberFormatInfo.NegativeSign e NumberFormatInfo.PositiveSign da cultura atual.
dígitos Uma sequência de dígitos decimais variando de 0 a 9.

Nota

A cadeia de caracteres especificada pelo parâmetro value não pode conter separadores de grupo ou separador decimal e não pode ter uma parte decimal.

O parâmetro s é interpretado usando o estilo NumberStyles.Integer. Além dos dígitos decimais, somente espaços à 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 em value, chame o método TryParse(String, NumberStyles, IFormatProvider, SByte).

O parâmetro s é analisado usando as informações de formatação em um objeto NumberFormatInfo para a cultura atual. Para obter mais informações, consulte NumberFormatInfo.CurrentInfo.

Essa sobrecarga interpreta todos os dígitos no parâmetro value como dígitos decimais. Para analisar a representação de cadeia de caracteres de um número hexadecimal, chame a sobrecarga de TryParse(String, NumberStyles, IFormatProvider, SByte).

Confira também

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 da cultura sobre s.

result
SByte

Quando esse método é retornado, contém o resultado da análise bem-sucedida de sou um valor indefinido sobre a falha.

Retornos

true se s foi 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 da cultura sobre s.

result
SByte

Quando esse método é retornado, contém o resultado da análise bem-sucedida de s ou de um valor indefinido sobre a falha.

Retornos

true se s foi 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 da cultura sobre utf8Text.

result
SByte

No retorno, contém o resultado da análise bem-sucedida de utf8Text ou de um valor indefinido sobre a falha.

Retornos

true se utf8Text foi 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 equivalente inteiro com sinal de 8 bits.

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 é retornado, contém o valor inteiro com sinal de 8 bits equivalente ao número contido no utf8Text se a conversão foi bem-sucedida ou zero se a conversão falhou. Esse parâmetro é passado sem inicialização; qualquer valor originalmente fornecido no resultado será substituído.

Retornos

true se utf8Text foi convertido com êxito; caso 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 de estilo e cultura especificado em seu SByte equivalente 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

Uma 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 é retornado, contém o valor inteiro com sinal de 8 bits equivalente ao número contido em s, se a conversão foi bem-sucedida ou zero se a conversão falhou. A conversão falhará se o parâmetro s for null ou Empty, não estiver em um formato compatível com styleou representar um número menor que SByte.MinValue ou maior que SByte.MaxValue. Esse parâmetro é passado sem inicialização; qualquer valor originalmente fornecido em result será substituído.

Retornos

true se s foi convertido com êxito; caso 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 formato específico de cultura e estilo especificado em seu SByte equivalente 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

Uma 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 é retornado, contém o valor inteiro com sinal de 8 bits equivalente ao número contido em s, se a conversão foi bem-sucedida ou zero se a conversão falhou. A conversão falhará se o parâmetro s for null ou Empty, não estiver em um formato compatível com styleou representar um número menor que SByte.MinValue ou maior que SByte.MaxValue. Esse parâmetro é passado sem inicialização; qualquer valor originalmente fornecido em result será substituído.

Retornos

true se s foi convertido com êxito; caso 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 método TryParse(String, NumberStyles, IFormatProvider, SByte) com vários valores de cadeia de caracteres e NumberStyles 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 método TryParse(String, NumberStyles, IFormatProvider, SByte) é como o método Parse(String, NumberStyles, IFormatProvider), 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ções para testar um FormatException se value for inválido e não puder ser analisado com êxito.

O parâmetro style define os elementos de estilo (como 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 tenha êxito. 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] [] [assinar] [dígitos,]dígitos[.fractional_digits][E[de sinal de]exponential_digits][ws]

Se o parâmetro style incluir AllowHexSpecifier, o parâmetro value poderá incluir os seguintes elementos:

[ws]hexdigits[ws]

Elementos em 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 poderá aparecer no início de value se style incluir o sinalizador NumberStyles.AllowLeadingWhite ou no final do value se style incluir o sinalizador NumberStyles.AllowTrailingWhite.
$ Um símbolo de moeda específico à cultura. Sua 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 poderá aparecer em value se style incluir o sinalizador NumberStyles.AllowCurrencySymbol.
assinar Um sinal opcional. O sinal poderá aparecer no início do value se style incluir o sinalizador NumberStyles.AllowLeadingSign e ele poderá aparecer no final do value se style incluir o sinalizador de NumberStyles.AllowTrailingSign. Parênteses podem ser usados em value para indicar um valor negativo se style incluir o sinalizador NumberStyles.AllowParentheses.
dígitos Uma sequência de dígitos de 0 a 9.
, Um separador de grupo específico à cultura. O separador de grupo da cultura especificada por provider poderá aparecer em value se style incluir o sinalizador NumberStyles.AllowThousands.
. Um símbolo de ponto decimal específico da cultura. O símbolo de ponto decimal da cultura especificada por provider poderá aparecer em value se style incluir o sinalizador NumberStyles.AllowDecimalPoint.
fractional_digits Uma ou mais ocorrências do dígito 0. Dígitos fracionários só poderão aparecer em value se style incluir o sinalizador NumberStyles.AllowDecimalPoint.
E O caractere "e" ou "E", que indica que o valor é representado na notação exponencial (científica). O parâmetro value pode representar um número na notação exponencial se style incluir 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 na notação exponencial se style incluir o sinalizador NumberStyles.AllowExponent.
hexdigits Uma sequência de dígitos hexadecimal de 0 a f ou 0 a F.

Nota

Todos os caracteres NUL de terminação (U+0000) em s são ignorados pela operação de análise, independentemente do valor do argumento style.

Uma cadeia de caracteres somente 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 não precisam estar presentes, nesta cadeia de caracteres de entrada. A tabela a seguir indica como membros NumberStyles individuais afetam os elementos que podem estar presentes no value.

Valores de NumberStyles não compostos Elementos permitidos em 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 de sinal de antes de dígitos.
AllowTrailingSign O elemento de sinal após dígitos.
AllowParentheses O sinal elemento 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 na notação exponencial.
Float O elemento ws no início ou no final de value, de sinal no início do valuee no símbolo decimal point (.). O parâmetro value também pode usar notação exponencial.
Number Os elementos ws, sign, separador de grupo (,) e decimal point (.).
Any Todos os elementos. No entanto, value não pode representar um número hexadecimal.

Se o sinalizador NumberStyles.AllowHexSpecifier for usado, value deverá 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 sinalizadores de espaço em branco.)

Nota

Se value for a representação de cadeia de caracteres de um número hexadecimal, ela não poderá ser precedida por qualquer decoração (como 0x ou &h) que a diferencie como um número hexadecimal. Isso faz com que a conversão falhe.

O parâmetro provider é uma implementação IFormatProvider. Seu método GetFormat retorna um objeto NumberFormatInfo que fornece informações específicas da 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. Seu 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 apenas retorna a si mesma.)

  • Um objeto personalizado que implementa IFormatProvider. Seu método GetFormat cria uma instância e retorna o objeto NumberFormatInfo que fornece informações de formatação.

Se provider for null, o objeto NumberFormatInfo da cultura atual será usado.

Confira também

Aplica-se a