UInt16.TryParse Método

Referência

Definição

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

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 não assinado de 16 bits equivalente. Um valor retornado indica se a conversão foi bem-sucedida ou falhou.

Sobrecargas

TryParse(String, UInt16)	Tenta converter a representação de cadeia de caracteres de um número no inteiro sem sinal de 16 bits equivalente. Um valor retornado indica se a conversão foi bem-sucedida ou falhou.
TryParse(ReadOnlySpan<Char>, IFormatProvider, UInt16)	Tenta analisar um intervalo de caracteres em um valor.
TryParse(String, IFormatProvider, UInt16)	Tenta analisar uma cadeia de caracteres em um valor.
TryParse(ReadOnlySpan<Char>, UInt16)	Tenta converter a representação de intervalo de um número no inteiro sem sinal de 16 bits equivalente. Um valor retornado indica se a conversão foi bem-sucedida ou falhou.
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, UInt16)	Tenta converter a representação de intervalo de um número em um formato específico da cultura e um estilo especificados em seu inteiro sem sinal de 16 bits equivalente. Um valor retornado indica se a conversão foi bem-sucedida ou falhou.
TryParse(String, NumberStyles, IFormatProvider, UInt16)	Tenta converter a representação de cadeia de caracteres de um número em um estilo e formato de cultura especificados em seu inteiro sem sinal de 16 bits equivalente. Um valor retornado indica se a conversão foi bem-sucedida ou falhou.

TryParse(String, UInt16)

Importante

Esta API não está em conformidade com CLS.

Alternativa em conformidade com CLS: System.Int32.TryParse(String, Int32)

Tenta converter a representação de cadeia de caracteres de um número no inteiro sem sinal de 16 bits equivalente. Um valor retornado indica se a conversão foi bem-sucedida ou falhou.

public:
 static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] System::UInt16 % result);

[System.CLSCompliant(false)]
public static bool TryParse (string s, out ushort result);

public static bool TryParse (string? s, out ushort result);

[System.CLSCompliant(false)]
public static bool TryParse (string? s, out ushort result);

[<System.CLSCompliant(false)>]
static member TryParse : string * uint16 -> bool

static member TryParse : string * uint16 -> bool

Public Shared Function TryParse (s As String, ByRef result As UShort) As Boolean

Parâmetros

s: String

Uma cadeia de caracteres que representa o número a ser convertido.

result: UInt16

Quando esse método for retornado, ele conterá o valor inteiro sem sinal de 16 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 UInt16.MinValue ou maior que UInt16.MaxValue. Este parâmetro é passado não inicializado; qualquer valor fornecido originalmente em result será substituído.

Retornos

Boolean

true caso s tenha sido convertido com êxito; do contrário, false.

Atributos: CLSCompliantAttribute

Exemplos

O exemplo a seguir chama o TryParse(String, UInt16) método uma vez para cada elemento em uma matriz de cadeia de caracteres.

string[] numericStrings = { "1293.8", "+1671.7", "28347.",  
                            "   33113684  ", "(0)", "-0", "-1", 
                            "+1293617", "18-", "119870", "31,024", 
                            "  3127094 ", "00700000" };
uint number;
foreach (string numericString in numericStrings)
{
   if (UInt32.TryParse(numericString, out number)) 
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number);
   else
      Console.WriteLine("Cannot convert '{0}' to a UInt32.", numericString);
}
// The example displays the following output:
//       Cannot convert '1293.8' to a UInt32.
//       Cannot convert '+1671.7' to a UInt32.
//       Cannot convert '28347.' to a UInt32.
//       Converted '   33113684  ' to 33113684.
//       Cannot convert '(0)' to a UInt32.
//       Converted '-0' to 0.
//       Cannot convert '-1' to a UInt32.
//       Converted '+1293617' to 1293617.
//       Cannot convert '18-' to a UInt32.
//       Converted '119870' to 119870.
//       Cannot convert '31,024' to a UInt32.
//       Converted '  3127094 ' to 3127094.
//       Converted '0070000' to 70000.

let numericStrings = 
    [| "1293.8"; "+1671.7"; "28347."
       "   33113684  "; "(0)"; "-0"; "-1" 
       "+1293617"; "18-"; "119870"; "31,024" 
       "  3127094 "; "00700000" |]

for numericString in numericStrings do
    match UInt32.TryParse numericString with
    | true, number ->
        printfn $"Converted '{numericString}' to {number}."
    | _ ->
        printfn $"Cannot convert '{numericString}' to a UInt32."
// The example displays the following output:
//       Cannot convert '1293.8' to a UInt32.
//       Cannot convert '+1671.7' to a UInt32.
//       Cannot convert '28347.' to a UInt32.
//       Converted '   33113684  ' to 33113684.
//       Cannot convert '(0)' to a UInt32.
//       Converted '-0' to 0.
//       Cannot convert '-1' to a UInt32.
//       Converted '+1293617' to 1293617.
//       Cannot convert '18-' to a UInt32.
//       Converted '119870' to 119870.
//       Cannot convert '31,024' to a UInt32.
//       Converted '  3127094 ' to 3127094.
//       Converted '0070000' to 70000.

Dim numericStrings() As String = {"1293.8", "+1671.7", "28347.", 
                                  "   33113684  ", "(0)", "-0", "-1",
                                  "+1293617", "18-", "119870", 
                                  "31,024", "  3127094 ", "0070000" }
Dim number As UInteger
For Each numericString As String In numericStrings
   If UInt32.TryParse(numericString, number) Then
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number)
   Else
      Console.WriteLine("Cannot convert '{0}' to a UInt32.", numericString)
   End If      
Next
' The example displays the following output:
'       Cannot convert '1293.8' to a UInt32.
'       Cannot convert '+1671.7' to a UInt32.
'       Cannot convert '28347.' to a UInt32.
'       Converted '   33113684  ' to 33113684.
'       Cannot convert '(0)' to a UInt32.
'       Converted '-0' to 0.
'       Cannot convert '-1' to a UInt32.
'       Converted '+1293617' to 1293617.
'       Cannot convert '18-' to a UInt32.
'       Converted '119870' to 119870.
'       Cannot convert '31,024' to a UInt32.
'       Converted '  3127094 ' to 3127094.
'       Converted '0070000' to 70000.

Comentários

O TryParse(String, UInt16) método é como o 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 s é 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 s 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 s, chame o TryParse(String, NumberStyles, IFormatProvider, UInt16) método .

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

Essa sobrecarga interpreta todos os dígitos no s 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, UInt16) sobrecarga.

Confira também

Aplica-se a

TryParse(ReadOnlySpan<Char>, IFormatProvider, UInt16)

Tenta analisar um intervalo de caracteres em um valor.

public:
 static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt16 % result) = ISpanParsable<System::UInt16>::TryParse;

public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider? provider, out ushort result);

static member TryParse : ReadOnlySpan<char> * IFormatProvider * uint16 -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As UShort) 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: UInt16

Quando esse método retorna, contém o resultado da análise sbem-sucedida de ou um valor indefinido em caso de falha.

Retornos

Boolean

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

Aplica-se a

TryParse(String, IFormatProvider, UInt16)

Tenta analisar uma cadeia de caracteres em um valor.

public:
 static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt16 % result) = IParsable<System::UInt16>::TryParse;

public static bool TryParse (string? s, IFormatProvider? provider, out ushort result);

static member TryParse : string * IFormatProvider * uint16 -> bool

Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As UShort) 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: UInt16

Quando este método retorna, contém o resultado da análise com êxito s ou um valor indefinido em caso de falha.

Retornos

Boolean

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

Aplica-se a

TryParse(ReadOnlySpan<Char>, UInt16)

Importante

Esta API não está em conformidade com CLS.

Tenta converter a representação de intervalo de um número no inteiro sem sinal de 16 bits equivalente. Um valor retornado indica se a conversão foi bem-sucedida ou falhou.

public:
 static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] System::UInt16 % result);

public static bool TryParse (ReadOnlySpan<char> s, out ushort result);

[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, out ushort result);

static member TryParse : ReadOnlySpan<char> * uint16 -> bool

[<System.CLSCompliant(false)>]
static member TryParse : ReadOnlySpan<char> * uint16 -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As UShort) As Boolean

Parâmetros

s: ReadOnlySpan<Char>

Um intervalo que contém os caracteres que representam o número a ser convertido.

result: UInt16

Quando esse método for retornado, ele conterá o valor inteiro sem sinal de 16 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 parâmetro s for null ou Empty se não estiver no formato correto. ou representa um número menor que UInt16.MinValue ou maior que UInt16.MaxValue. Este parâmetro é passado não inicializado; qualquer valor fornecido originalmente em result será substituído.

Retornos

Boolean

true caso s tenha sido convertido com êxito; do contrário, false.

Atributos: CLSCompliantAttribute

Aplica-se a

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

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 inteiro sem sinal de 16 bits equivalente. Um valor retornado indica se a conversão foi bem-sucedida ou falhou.

public:
 static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt16 % result);

public:
 static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt16 % result) = System::Numerics::INumberBase<System::UInt16>::TryParse;

public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out ushort result);

[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider provider, out ushort result);

[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out ushort result);

static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * uint16 -> bool

[<System.CLSCompliant(false)>]
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * uint16 -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As UShort) As Boolean

Parâmetros

s: ReadOnlySpan<Char>

Um intervalo que contém os caracteres que representam o número a ser convertido. O intervalo é interpretado usando o estilo especificado pelo parâmetro style.

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: UInt16

Quando esse método for retornado, ele conterá o equivalente do valor inteiro sem sinal de 16 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 styleou representar um número menor que UInt16.MinValue ou maior que UInt16.MaxValue. Este parâmetro é passado não inicializado; qualquer valor fornecido originalmente em result será substituído.

Retornos

Boolean

true caso s tenha sido convertido com êxito; do contrário, false.

Atributos: CLSCompliantAttribute

Aplica-se a

TryParse(String, NumberStyles, IFormatProvider, UInt16)

Importante

Esta API não está em conformidade com CLS.

Alternativa em conformidade com CLS: System.Int32.TryParse(String, Int32)

Tenta converter a representação de cadeia de caracteres de um número em um estilo e formato de cultura especificados em seu inteiro sem sinal de 16 bits equivalente. Um valor retornado indica se a conversão foi bem-sucedida ou falhou.

public:
 static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt16 % result);

public:
 static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt16 % result) = System::Numerics::INumberBase<System::UInt16>::TryParse;

[System.CLSCompliant(false)]
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out ushort result);

public static bool TryParse (string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out ushort result);

[System.CLSCompliant(false)]
public static bool TryParse (string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out ushort result);

[<System.CLSCompliant(false)>]
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * uint16 -> bool

static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * uint16 -> bool

Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As UShort) As Boolean

Parâmetros

s: String

Uma cadeia de caracteres que representa o número a ser convertido. A cadeia de caracteres é interpretada usando-se o estilo especificado pelo parâmetro style.

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: UInt16

Retornos

Boolean

true caso s tenha sido convertido com êxito; do contrário, false.

Atributos: CLSCompliantAttribute

Exceções

ArgumentException

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, UInt16) 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 = "10603";
      styles = NumberStyles.Integer;
      CallTryParse(numericString, styles);
      
      numericString = "-10603";
      styles = NumberStyles.None;
      CallTryParse(numericString, styles);
      
      numericString = "29103.00";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);
      
      numericString = "10345.72";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);

      numericString = "2210E-01";
      styles = NumberStyles.Integer | NumberStyles.AllowExponent;
      CallTryParse(numericString, styles); 
      
      numericString = "9112E-01";
      CallTryParse(numericString, styles);
          
      numericString = "312E01";
      CallTryParse(numericString, styles); 
      
      numericString = "FFC8";
      CallTryParse(numericString, NumberStyles.HexNumber);
      
      numericString = "0x8F8C";
      CallTryParse(numericString, NumberStyles.HexNumber);
   }
   
   private static void CallTryParse(string stringToConvert, NumberStyles styles)
   {
      ushort number;
      bool result = UInt16.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 '10603' to 10603.
//       Attempted conversion of '-10603' failed.
//       Converted '29103.00' to 29103.
//       Attempted conversion of '10345.72' failed.
//       Converted '2210E-01' to 221.
//       Attempted conversion of '9112E-01' failed.
//       Converted '312E01' to 3120.
//       Converted 'FFC8' to 65480.
//       Attempted conversion of '0x8F8C' failed.

open System
open System.Globalization

let callTryParse (stringToConvert: string) (styles: NumberStyles) =
    match UInt16.TryParse(stringToConvert, styles, CultureInfo.InvariantCulture) with
    | true, number ->
        printfn $"Converted '{stringToConvert}' to {number}."
    | _ -> 
        printfn $"Attempted conversion of '{stringToConvert}' failed."

do
    let numericString = "10603"
    let styles = NumberStyles.Integer
    callTryParse numericString styles
    
    let numericString = "-10603"
    let styles = NumberStyles.None
    callTryParse numericString styles
    
    let numericString = "29103.00"
    let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
    callTryParse numericString styles
    
    let numericString = "10345.72"
    let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
    callTryParse numericString styles

    let numericString = "2210E-01"
    let styles = NumberStyles.Integer ||| NumberStyles.AllowExponent
    callTryParse numericString styles
    
    let numericString = "9112E-01"
    callTryParse numericString styles
        
    let numericString = "312E01"
    callTryParse numericString styles
    
    let numericString = "FFC8"
    callTryParse numericString NumberStyles.HexNumber
    
    let numericString = "0x8F8C"
    callTryParse numericString NumberStyles.HexNumber
// The example displays the following output:
//       Converted '10603' to 10603.
//       Attempted conversion of '-10603' failed.
//       Converted '29103.00' to 29103.
//       Attempted conversion of '10345.72' failed.
//       Converted '2210E-01' to 221.
//       Attempted conversion of '9112E-01' failed.
//       Converted '312E01' to 3120.
//       Converted 'FFC8' to 65480.
//       Attempted conversion of '0x8F8C' failed.

Imports System.Globalization

Module Example
   Public Sub Main()
      Dim numericString As String
      Dim styles As NumberStyles
      
      numericString = "10603"
      styles = NumberStyles.Integer
      CallTryParse(numericString, styles)
      
      numericString = "-10603"
      styles = NumberStyles.None
      CallTryParse(numericString, styles)
      
      numericString = "29103.00"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)
      
      numericString = "10345.72"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)

      numericString = "2210E-01"
      styles = NumberStyles.Integer Or NumberStyles.AllowExponent
      CallTryParse(numericString, styles) 
      
      numericString = "9112E-01"
      CallTryParse(numericString, styles)
          
      numericString = "312E01"
      CallTryParse(numericString, styles) 
      
      numericString = "FFC8"
      CallTryParse(numericString, NumberStyles.HexNumber)
      
      numericString = "0x8F8C"
      CallTryParse(numericString, NumberStyles.HexNumber)
   End Sub
   
   Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
      Dim number As UShort
      Dim result As Boolean = UInt16.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 '10603' to 10603.
'       Attempted conversion of '-10603' failed.
'       Converted '29103.00' to 29103.
'       Attempted conversion of '10345.72' failed.
'       Converted '2210E-01' to 221.
'       Attempted conversion of '9112E-01' failed.
'       Converted '312E01' to 3120.
'       Converted 'FFC8' to 65480.
'       Attempted conversion of '0x8F8C' failed.

Comentários

O TryParse(String, NumberStyles, IFormatProvider, UInt16) método é como o 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 s é 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 s 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 s pode incluir os seguintes elementos:

[ws] [$][sign][digits,]digits[. fractional_digits][E[sign]exponential_digits][ws]

Itens entre colchetes ([ e ]) são opcionais. Ou, se o style parâmetro incluir AllowHexSpecifier, o s parâmetro poderá incluir os seguintes elementos:

[ws] hexdigits[ws]

A tabela a seguir descreve cada elemento.

Ws Espaço em branco opcional. O espaço em branco pode aparecer no início de s se incluir o NumberStyles.AllowLeadingWhite sinalizador ou no final de s se style incluir o NumberStyles.AllowTrailingWhite sinalizador.style

$ Um símbolo de moeda específico da 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 s caso style inclua o sinalizador NumberStyles.AllowCurrencySymbol.

Sinal Um sinal opcional. O sinal pode ser exibido no início de s caso style inclua o sinalizador NumberStyles.AllowLeadingSign e ele pode ser exibido no final de s caso style inclua o sinalizador NumberStyles.AllowTrailingSign. Os parênteses podem ser usados em s para indicar um valor negativo caso style inclua o sinalizador NumberStyles.AllowParentheses. No entanto, se o sinal negativo estiver presente, s só poderá representar o valor zero para que a operação de análise seja bem-sucedida.

Dígitos Uma sequência de dígitos de 0 a 9.

, Um separador de grupo específico da cultura. O separador de grupo da cultura especificada por provider poderá aparecer em s 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 s caso style inclua o sinalizador NumberStyles.AllowDecimalPoint.

Fractional_digits Uma ou mais ocorrências do dígito 0. Os dígitos fracionários só podem ser exibidos em s 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 s 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 s 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 0 a F.

Observação

Todos os caracteres NUL de terminação (U+0000) em 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 s.

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 dígitos ou o método retorna `false`.
AllowExponent	O caractere "e" ou "E", que indica notação exponencial, juntamente com exponential_digits. Se `s` 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 `s`.
AllowTrailingWhite	O elemento ws no final de `s`.
AllowLeadingSign	O elemento sign antes dos dígitos.
AllowTrailingSign	O elemento de sinal após dígitos.
AllowParentheses	O elemento sign na forma de parênteses que inclui um valor numérico zero.
AllowThousands	O elemento separador de grupo (,).
AllowCurrencySymbol	O elemento currency ($).
Currency	Todos os elementos. No entanto, `s` 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 `s`, assina no início de `s`e o símbolo de ponto decimal (.). O parâmetro `s` também pode usar notação exponencial.
Number	Os elementos ws, sign, separador de grupo (,) e ponto decimal (.).
Any	Todos os elementos. No entanto, `s` não pode representar um número hexadecimal.

Caso o sinalizador NumberStyles.AllowHexSpecifier seja usado, s deve ser um valor hexadecimal. Os dígitos hexadecimais válidos são de 0 a 9, a a f e A a F. Não há suporte para um prefixo como "0x" e faz com que a operação de análise falhe. 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 s 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 s. 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

UInt16.TryParse Método

Definição

Sobrecargas

TryParse(String, UInt16)

Parâmetros

Retornos

Exemplos

Comentários

Confira também

Aplica-se a

TryParse(ReadOnlySpan<Char>, IFormatProvider, UInt16)

Parâmetros

Retornos

Aplica-se a

TryParse(String, IFormatProvider, UInt16)

Parâmetros

Retornos

Aplica-se a

TryParse(ReadOnlySpan<Char>, UInt16)

Parâmetros

Retornos

Aplica-se a

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

Parâmetros

Retornos

Aplica-se a

TryParse(String, NumberStyles, IFormatProvider, UInt16)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Recursos adicionais