Int16.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 de cadeia de caracteres de um número no inteiro com sinal de 16 bits equivalente. Um valor retornado indica se a conversão foi bem-sucedida ou falhou.
Sobrecargas
TryParse(ReadOnlySpan<Byte>, IFormatProvider, Int16) |
Tenta analisar um intervalo de caracteres UTF-8 em um valor. |
TryParse(ReadOnlySpan<Char>, Int16) |
Converte a representação de intervalo de um número em um formato específico da cultura e um estilo especificados em seu equivalente de inteiro com sinal de 16 bits. Um valor retornado indica se a conversão foi bem-sucedida ou falhou. |
TryParse(String, Int16) |
Converte a representação de cadeia de caracteres de um número no inteiro com sinal de 16 bits equivalente. Um valor retornado indica se a conversão foi bem-sucedida ou falhou. |
TryParse(ReadOnlySpan<Char>, IFormatProvider, Int16) |
Tenta analisar um intervalo de caracteres em um valor. |
TryParse(String, IFormatProvider, Int16) |
Tenta analisar uma cadeia de caracteres em um valor. |
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, Int16) |
Tenta analisar um intervalo de caracteres UTF-8 em um valor. |
TryParse(ReadOnlySpan<Byte>, Int16) |
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 16 bits equivalente. |
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Int16) |
Converte a representação de intervalo de um número em um formato específico da cultura e um estilo especificados em seu equivalente de inteiro com sinal de 16 bits. Um valor retornado indica se a conversão foi bem-sucedida ou falhou. |
TryParse(String, NumberStyles, IFormatProvider, Int16) |
Converte a representação de cadeia de caracteres de um número em um estilo e formato específico da cultura especificados em seu equivalente de inteiro com sinal de 16 bits. Um valor retornado indica se a conversão foi bem-sucedida ou falhou. |
TryParse(ReadOnlySpan<Byte>, IFormatProvider, Int16)
- Origem:
- Int16.cs
- Origem:
- Int16.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] short % result) = IUtf8SpanParsable<short>::TryParse;
public static bool TryParse (ReadOnlySpan<byte> utf8Text, IFormatProvider? provider, out short result);
static member TryParse : ReadOnlySpan<byte> * IFormatProvider * int16 -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider, ByRef result As Short) 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
- Int16
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>, Int16)
- Origem:
- Int16.cs
- Origem:
- Int16.cs
- Origem:
- Int16.cs
Converte a representação de intervalo de um número em um formato específico da cultura e um estilo especificados em seu equivalente de inteiro com sinal de 16 bits. Um valor retornado indica se a conversão foi bem-sucedida ou falhou.
public:
static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] short % result);
public static bool TryParse (ReadOnlySpan<char> s, out short result);
static member TryParse : ReadOnlySpan<char> * int16 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As Short) As Boolean
Parâmetros
- s
- ReadOnlySpan<Char>
Um intervalo que contém os caracteres que representam o número a ser convertido.
- result
- Int16
Quando esse método for retornado, conterá o equivalente do valor inteiro com sinal de 16 bits do número contido em s
, se a conversão tiver sido bem-sucedida, ou conterá 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 Int16.MinValue ou maior que Int16.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
.
Aplica-se a
TryParse(String, Int16)
- Origem:
- Int16.cs
- Origem:
- Int16.cs
- Origem:
- Int16.cs
Converte a representação de cadeia de caracteres de um número no inteiro com 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] short % result);
public static bool TryParse (string s, out short result);
public static bool TryParse (string? s, out short result);
static member TryParse : string * int16 -> bool
Public Shared Function TryParse (s As String, ByRef result As Short) As Boolean
Parâmetros
- s
- String
Uma cadeia de caracteres que contém um número a ser convertido.
- result
- Int16
Quando esse método for retornado, conterá o equivalente do valor inteiro com sinal de 16 bits do número contido em s
, se a conversão tiver sido bem-sucedida, ou conterá zero, se a conversão tiver falhado. A conversão falhará se o s
parâmetro for null
ou Empty, não for do formato correto ou representar um número menor que Int16.MinValue ou maior que Int16.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
.
Exemplos
O exemplo a seguir chama o Int16.TryParse(String, Int16) método com vários valores de cadeia de caracteres diferentes.
using System;
public class StringParsing
{
public static void Main()
{
TryToParse(null);
TryToParse("16051");
TryToParse("9432.0");
TryToParse("16,667");
TryToParse(" -322 ");
TryToParse("+4302");
TryToParse("(100);");
TryToParse("01FA");
}
private static void TryToParse(string value)
{
short number;
bool result = Int16.TryParse(value, out number);
if (result)
{
Console.WriteLine("Converted '{0}' to {1}.", value, number);
}
else
{
if (value == null) value = "";
Console.WriteLine("Attempted conversion of '{0}' failed.", value);
}
}
}
// The example displays the following output to the console:
// Attempted conversion of '' failed.
// Converted '16051' to 16051.
// Attempted conversion of '9432.0' failed.
// Attempted conversion of '16,667' failed.
// Converted ' -322 ' to -322.
// Converted '+4302' to 4302.
// Attempted conversion of '(100)' failed.
// Attempted conversion of '01FA' failed.
open System
let tryToParse (value: string) =
match Int16.TryParse value with
| true, number -> printfn "Converted '{value}' to {number}."
| _ ->
let value = if isNull value then "" else value
printfn $"Attempted conversion of '{value}' failed."
tryToParse null
tryToParse "16051"
tryToParse "9432.0"
tryToParse "16,667"
tryToParse " -322 "
tryToParse "+4302"
tryToParse "(100);"
tryToParse "01FA"
// The example displays the following output to the console:
// Attempted conversion of '' failed.
// Converted '16051' to 16051.
// Attempted conversion of '9432.0' failed.
// Attempted conversion of '16,667' failed.
// Converted ' -322 ' to -322.
// Converted '+4302' to 4302.
// Attempted conversion of '(100)' failed.
// Attempted conversion of '01FA' failed.
Module StringParsing
Public Sub Main()
TryToParse(Nothing)
TryToParse("16051")
TryToParse("9432.0")
TryToParse("16,667")
TryToParse(" -322 ")
TryToParse("+4302")
TryToParse("(100)")
TryToParse("01FA")
End Sub
Private Sub TryToParse(value As String)
Dim number As Int16
Dim result As Boolean = Int16.TryParse(value, number)
If result Then
Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
If value Is Nothing Then value = ""
Console.WriteLine("Attempted conversion of '{0}' failed.", value)
End If
End Sub
End Module
' The example displays the following output to the console:
' Attempted conversion of '' failed.
' Converted '16051' to 16051.
' Attempted conversion of '9432.0' failed.
' Attempted conversion of '16,667' failed.
' Converted ' -322 ' to -322.
' Converted '+4302' to 4302.
' Attempted conversion of '(100)' failed.
' Attempted conversion of '01FA' failed.
Algumas das cadeias de caracteres que o TryParse(String, Int16) método não consegue converter neste exemplo são:
"9432.0". A conversão falha porque a cadeia de caracteres não pode conter um separador decimal; ele deve conter apenas dígitos integrais.
"16,667". A conversão falha porque a cadeia de caracteres não pode conter separadores de grupo; ele deve conter apenas dígitos integrais.
"(100)". A conversão falha porque a cadeia de caracteres não pode conter um sinal negativo diferente do definido pelas propriedades e NumberFormatInfo.NumberNegativePattern da NumberFormatInfo.NegativeSign cultura atual.
"01FA". A conversão falha porque a cadeia de caracteres não pode conter dígitos hexadecimal; ele deve conter apenas dígitos decimais.
Comentários
O Int16.TryParse(String, Int16) método difere do Int16.Parse(String) método retornando um valor booliano que indica se a operação de análise foi bem-sucedida em vez de retornar o valor analisado Int16 . Ele elimina a necessidade de usar a identificação de exceções para testar um FormatException caso esse s
seja inválido e não possa ser analisado com êxito.
O s
parâmetro deve ser a representação de cadeia de caracteres de um número no formulário:
[ws][sign]digits[ws]
Itens 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. |
dígitos | Uma sequência de dígitos que varia de 0 a 9. |
O parâmetro s
é interpretado usando-se o estilo NumberStyles.Integer. Além dos dígitos decimais, somente espaços à esquerda e à direita, juntamente com um sinal à esquerda, são permitidos. Para definir explicitamente os elementos de estilo junto com as informações de formatação específicas da cultura que podem estar presentes no s
, use o Int16.TryParse(String, NumberStyles, IFormatProvider, Int16) método .
O parâmetro s
é analisado usando-se as informações de formatação em um objeto NumberFormatInfo que é inicializado para a cultura do sistema atual. Para obter mais informações, consulte CurrentInfo.
Essa sobrecarga do TryParse método 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 Int16.TryParse(String, NumberStyles, IFormatProvider, Int16) sobrecarga.
Confira também
- Parse(String)
- ToString()
- Analisando cadeias de caracteres numéricas no .NET
- 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, Int16)
- Origem:
- Int16.cs
- Origem:
- Int16.cs
- Origem:
- Int16.cs
Tenta analisar um intervalo de caracteres em um valor.
public:
static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] short % result) = ISpanParsable<short>::TryParse;
public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider? provider, out short result);
static member TryParse : ReadOnlySpan<char> * IFormatProvider * int16 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As Short) 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
- Int16
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, Int16)
- Origem:
- Int16.cs
- Origem:
- Int16.cs
- Origem:
- Int16.cs
Tenta analisar uma cadeia de caracteres em um valor.
public:
static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] short % result) = IParsable<short>::TryParse;
public static bool TryParse (string? s, IFormatProvider? provider, out short result);
static member TryParse : string * IFormatProvider * int16 -> bool
Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As Short) 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
- Int16
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, Int16)
- Origem:
- Int16.cs
- Origem:
- Int16.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] short % result) = System::Numerics::INumberBase<short>::TryParse;
public static bool TryParse (ReadOnlySpan<byte> utf8Text, System.Globalization.NumberStyles style, IFormatProvider? provider, out short result);
static member TryParse : ReadOnlySpan<byte> * System.Globalization.NumberStyles * IFormatProvider * int16 -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), style As NumberStyles, provider As IFormatProvider, ByRef result As Short) 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
- Int16
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>, Int16)
- Origem:
- Int16.cs
- Origem:
- Int16.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 16 bits equivalente.
public:
static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, [Runtime::InteropServices::Out] short % result);
public static bool TryParse (ReadOnlySpan<byte> utf8Text, out short result);
static member TryParse : ReadOnlySpan<byte> * int16 -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), ByRef result As Short) 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
- Int16
Quando esse método retorna, contém o valor inteiro com sinal de 16 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, Int16)
- Origem:
- Int16.cs
- Origem:
- Int16.cs
- Origem:
- Int16.cs
Converte a representação de intervalo de um número em um formato específico da cultura e um estilo especificados em seu equivalente de inteiro com sinal de 16 bits. 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] short % result);
public:
static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] short % result) = System::Numerics::INumberBase<short>::TryParse;
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out short result);
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider provider, out short result);
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * int16 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As Short) 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 por style
.
- style
- NumberStyles
Um combinação bit a bit de valores de enumeração que indica os elementos de estilo que podem estar presentes em 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
- Int16
Quando esse método for retornado, conterá o equivalente do valor inteiro com sinal de 16 bits do número contido em s
, se a conversão tiver sido bem-sucedida, ou conterá 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 Int16.MinValue ou maior que Int16.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
.
Aplica-se a
TryParse(String, NumberStyles, IFormatProvider, Int16)
- Origem:
- Int16.cs
- Origem:
- Int16.cs
- Origem:
- Int16.cs
Converte a representação de cadeia de caracteres de um número em um estilo e formato específico da cultura especificados em seu equivalente de inteiro com sinal de 16 bits. 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] short % result);
public:
static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] short % result) = System::Numerics::INumberBase<short>::TryParse;
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out short result);
public static bool TryParse (string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out short result);
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * int16 -> bool
Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As Short) As Boolean
Parâmetros
- s
- String
Uma cadeia de caracteres que contém um número a ser convertido. A cadeia de caracteres é interpretada usando o estilo especificado por style
.
- style
- NumberStyles
Um combinação bit a bit de valores de enumeração que indica os elementos de estilo que podem estar presentes em 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
- Int16
Quando esse método for retornado, conterá o equivalente do valor inteiro com sinal de 16 bits do número contido em s
, se a conversão tiver sido bem-sucedida, ou conterá 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 Int16.MinValue ou maior que Int16.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
.
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 Int16.TryParse(String, NumberStyles, IFormatProvider, Int16) método com vários valores de cadeia de caracteres diferentes.
using System;
using System.Globalization;
public class StringParsing
{
public static void Main()
{
string numericString;
NumberStyles styles;
numericString = "10677";
styles = NumberStyles.Integer;
CallTryParse(numericString, styles);
numericString = "-30677";
styles = NumberStyles.None;
CallTryParse(numericString, styles);
numericString = "10345.00";
styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
CallTryParse(numericString, styles);
numericString = "10345.72";
styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
CallTryParse(numericString, styles);
numericString = "22,593";
styles = NumberStyles.Integer | NumberStyles.AllowThousands;
CallTryParse(numericString, styles);
numericString = "12E-01";
styles = NumberStyles.Integer | NumberStyles.AllowExponent;
CallTryParse(numericString, styles);
numericString = "12E03";
CallTryParse(numericString, styles);
numericString = "80c1";
CallTryParse(numericString, NumberStyles.HexNumber);
numericString = "0x80C1";
CallTryParse(numericString, NumberStyles.HexNumber);
}
private static void CallTryParse(string stringToConvert, NumberStyles styles)
{
short number;
bool result = Int16.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 to the console:
// Converted '10677' to 10677.
// Attempted conversion of '-30677' failed.
// Converted '10345.00' to 10345.
// Attempted conversion of '10345.72' failed.
// Converted '22,593' to 22593.
// Attempted conversion of '12E-01' failed.
// Converted '12E03' to 12000.
// Converted '80c1' to -32575.
// Attempted conversion of '0x80C1' failed.
open System
open System.Globalization
let callTryParse (stringToConvert: string) (styles: NumberStyles) =
match Int16.TryParse(stringToConvert, styles, CultureInfo.InvariantCulture) with
| true, number ->
printfn $"Converted '{stringToConvert}' to {number}."
| _ ->
printfn $"Attempted conversion of '{stringToConvert}' failed."
[<EntryPoint>]
let main _ =
let numericString = "10677"
let styles = NumberStyles.Integer
callTryParse numericString styles
let numericString = "-30677"
let styles = NumberStyles.None
callTryParse numericString styles
let numericString = "10345.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 = "22,593"
let styles = NumberStyles.Integer ||| NumberStyles.AllowThousands
callTryParse numericString styles
let numericString = "12E-01"
let styles = NumberStyles.Integer ||| NumberStyles.AllowExponent
callTryParse numericString styles
let numericString = "12E03"
callTryParse numericString styles
let numericString = "80c1"
callTryParse numericString NumberStyles.HexNumber
let numericString = "0x80C1"
callTryParse numericString NumberStyles.HexNumber
0
// The example displays the following output to the console:
// Converted '10677' to 10677.
// Attempted conversion of '-30677' failed.
// Converted '10345.00' to 10345.
// Attempted conversion of '10345.72' failed.
// Converted '22,593' to 22593.
// Attempted conversion of '12E-01' failed.
// Converted '12E03' to 12000.
// Converted '80c1' to -32575.
// Attempted conversion of '0x80C1' failed.
Imports System.Globalization
Module StringParsing
Public Sub Main()
Dim numericString As String
Dim styles As NumberStyles
numericString = "10677"
styles = NumberStyles.Integer
CallTryParse(numericString, styles)
numericString = "-30677"
styles = NumberStyles.None
CallTryParse(numericString, styles)
numericString = "10345.00"
styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
CallTryParse(numericString, styles)
numericString = "10345.72"
styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
CallTryParse(numericString, styles)
numericString = "22,593"
styles = NumberStyles.Integer Or NumberStyles.AllowThousands
CallTryParse(numericString, styles)
numericString = "12E-01"
styles = NumberStyles.Integer Or NumberStyles.AllowExponent
CallTryParse(numericString, styles)
numericString = "12E03"
CallTryParse(numericString, styles)
numericString = "80c1"
CallTryParse(numericString, NumberStyles.HexNumber)
numericString = "0x80C1"
CallTryParse(numericString, NumberStyles.HexNumber)
End Sub
Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
Dim number As Short
Dim result As Boolean = Int16.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 '10677' to 10677.
' Attempted conversion of '-30677' failed.
' Converted '10345.00' to 10345.
' Attempted conversion of '10345.72' failed.
' Converted '22,593' to 22593.
' Attempted conversion of '12E-01' failed.
' Converted '12E03' to 12000.
' Converted '80c1' to -32575.
' Attempted conversion of '0x80C1' failed.
Comentários
O Int16.TryParse(String, NumberStyles, IFormatProvider, Int16) método difere do Int16.Parse(String, NumberStyles, IFormatProvider) método retornando um valor booliano que indica se a operação de análise foi bem-sucedida em vez de retornar o valor analisado Int16 . Ele elimina a necessidade de usar a identificação de exceções para testar um FormatException caso esse s
seja inválido e não possa 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 do estilo, o s
parâmetro pode incluir os seguintes elementos:
[ws][$][sign][digits,]digits[.fractional_digits][e[sign]digits][ws]
Ou, se o style
parâmetro incluir NumberStyles.AllowHexSpecifier:
[ws]hexdigits[ws]
Itens 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 ser exibido no início de s caso style inclua o sinalizador NumberStyles.AllowLeadingWhite ou no final de s caso style inclua o sinalizador NumberStyles.AllowTrailingWhite. |
$ | 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 s caso style inclua o sinalizador NumberStyles.AllowCurrencySymbol. |
sign | Um sinal opcional. |
dígitos | Uma sequência de dígitos de 0 a 9. |
, | Um separador de milhares específico da cultura. O separador de milhares da cultura especificada por provider pode ser exibido em s caso style inclua o sinalizador NumberStyles.AllowThousands. |
. | 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 de 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 se o valor é representado na notação exponencial. 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 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 dos membros NumberStyles restantes que podem estar, mas que não precisam estar presentes nessa 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 em s além de dígitos |
---|---|
NumberStyles.None | Somente dígitos decimais. |
NumberStyles.AllowDecimalPoint | Os elementos . e fractional_digits . No entanto, fractional_digits deve consistir em apenas um ou mais 0 dígitos ou o método retorna false . |
NumberStyles.AllowExponent | O parâmetro s também pode usar notação exponencial. Se s representar um número na notação exponencial, ele deverá representar um inteiro dentro do intervalo do tipo de Int16 dados sem um componente fracionário diferente de zero. |
NumberStyles.AllowLeadingWhite | O elemento ws no início de s. |
NumberStyles.AllowTrailingWhite | O elemento ws no final de s. |
NumberStyles.AllowLeadingSign | Um sinal pode aparecer antes dos dígitos. |
NumberStyles.AllowTrailingSign | Um sinal pode aparecer após dígitos. |
NumberStyles.AllowParentheses | O elemento sinal na forma de parênteses que incluem o valor numérico. |
NumberStyles.AllowThousands | O elemento , . |
NumberStyles.AllowCurrencySymbol | O $ elemento . |
NumberStyles.Currency | Todos os elementos. O parâmetro s não pode representar um número hexadecimal ou um número em notação exponencial. |
NumberStyles.Float | O elemento ws no início ou no final de s , assina no início de s e no símbolo . O parâmetro s também pode usar notação exponencial. |
NumberStyles.Number | Os elementos ws, sign, separador de milhares (,) e ponto decimal (.). |
NumberStyles.Any | Todos os estilos, exceto caso s não possa representar um número hexadecimal. |
Se o NumberStyles.AllowHexSpecifier sinalizador for usado, s
deverá ser um valor hexadecimal sem um prefixo. Por exemplo, "9AF3" analisa com êxito, mas "0x9AF3" não. Os únicos outros sinalizadores que podem estar presentes em style
são NumberStyles.AllowLeadingWhite e NumberStyles.AllowTrailingWhite. (A NumberStyles enumeração tem um estilo composto, NumberStyles.HexNumber, que inclui os dois sinalizadores de espaço em branco.)
O parâmetro provider
é uma implementação de IFormatProvider, como um objeto CultureInfo ou um objeto NumberFormatInfo, cujo método GetFormat retorna um objeto NumberFormatInfo. O objeto NumberFormatInfo fornece informações específicas da cultura sobre o formato de s
. 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