Partilhar via


Conversion.Val Método

Definição

Retorna os números contidos em uma cadeia de caracteres como um valor numérico do tipo apropriado.

Sobrecargas

Val(Object)

Retorna os números contidos em uma cadeia de caracteres como um valor numérico do tipo apropriado.

Val(Char)

Retorna os números contidos em uma cadeia de caracteres como um valor numérico do tipo apropriado.

Val(String)

Retorna os números contidos em uma cadeia de caracteres como um valor numérico do tipo apropriado.

Val(Object)

Origem:
Conversion.vb
Origem:
Conversion.vb
Origem:
Conversion.vb

Retorna os números contidos em uma cadeia de caracteres como um valor numérico do tipo apropriado.

public:
 static double Val(System::Object ^ Expression);
public static double Val (object? Expression);
public static double Val (object Expression);
static member Val : obj -> double
Public Function Val (Expression As Object) As Double

Parâmetros

Expression
Object

Obrigatórios. Qualquer expressão String válida, variável Object ou valor Char. Se Expression for do tipo Object, seu valor deverá ser conversível para String ou um erro ArgumentException ocorrerá.

Retornos

Os números contidos em uma cadeia de caracteres como um valor numérico do tipo apropriado.

Exceções

InputStr é muito grande.

Expression é uma expressão de tipo Object não conversível para String.

Exemplos

O exemplo a seguir usa a Val função para retornar os números contidos em cada cadeia de caracteres. Val interrompe a conversão no primeiro caractere que não pode ser interpretado como um dígito numérico, modificador numérico, pontuação numérica ou espaço em branco.

Dim valResult As Double
' The following line of code sets valResult to 2457.
valResult = Val("2457")
' The following line of code sets valResult to 2457.
valResult = Val(" 2 45 7")
' The following line of code sets valResult to 24.
valResult = Val("24 and 57")

Comentários

A Val função para de ler a cadeia de caracteres no primeiro caractere que não pode reconhecer como parte de um número. Símbolos e caracteres que geralmente são considerados partes de valores numéricos, como cifrões e vírgulas, não são reconhecidos. No entanto, a função reconhece os prefixos &O radix (para octal) e &H (para hexadecimal). Espaços em branco, guias e caracteres de alimentação de linha são removidos do argumento.

A chamada a seguir retorna o valor 1234123.

Val(" 1234 123th Street N.E.")   

A chamada a seguir retorna o valor decimal -1.

Val("&HFFFF")   

Observação

A Val função reconhece apenas o período (.) como um separador decimal válido. Quando outros separadores decimais são usados, como em aplicativos internacionais, use CDbl ou CInt , em vez disso, para converter uma cadeia de caracteres em um número. Para converter a representação de cadeia de caracteres de um número em uma cultura específica em um valor numérico, use o método do Parse(String, IFormatProvider) tipo numérico. Por exemplo, use Double.Parse ao converter uma cadeia de caracteres em um Double.

Observação

Uma InvalidCastException exceção pode ser gerada em resposta a determinados formatos de número incomuns. Por exemplo, o código a seguir gera essa exceção.

' These examples cause run-time errors.

'Console.WriteLine(Val("1.34%"))

'Console.WriteLine(Val("1.34&"))

O conflito entre o número formatado como um Double e os Integer caracteres de tipo e Long será capturado pelo compilador se o conflito não estiver contido em cadeias de caracteres.

' These examples cause compiler errors.

'Dim m = 1.34%

'Dim n = 1.34&

Confira também

Aplica-se a

Val(Char)

Origem:
Conversion.vb
Origem:
Conversion.vb
Origem:
Conversion.vb

Retorna os números contidos em uma cadeia de caracteres como um valor numérico do tipo apropriado.

public:
 static int Val(char Expression);
public static int Val (char Expression);
static member Val : char -> int
Public Function Val (Expression As Char) As Integer

Parâmetros

Expression
Char

Obrigatórios. Qualquer expressão String válida, variável Object ou valor Char. Se Expression for do tipo Object, seu valor deverá ser conversível para String ou um erro ArgumentException ocorrerá.

Retornos

Os números contidos em uma cadeia de caracteres como um valor numérico do tipo apropriado.

Exceções

InputStr é muito grande.

Expression é uma expressão de tipo Object não conversível para String.

Exemplos

O exemplo a seguir usa a Val função para retornar os números contidos em cada cadeia de caracteres. Val interrompe a conversão no primeiro caractere que não pode ser interpretado como um dígito numérico, modificador numérico, pontuação numérica ou espaço em branco.

Dim valResult As Double
' The following line of code sets valResult to 2457.
valResult = Val("2457")
' The following line of code sets valResult to 2457.
valResult = Val(" 2 45 7")
' The following line of code sets valResult to 24.
valResult = Val("24 and 57")

Comentários

A Val função para de ler a cadeia de caracteres no primeiro caractere que não pode reconhecer como parte de um número. Símbolos e caracteres que geralmente são considerados partes de valores numéricos, como cifrões e vírgulas, não são reconhecidos. No entanto, a função reconhece os prefixos &O radix (para octal) e &H (para hexadecimal). Espaços em branco, guias e caracteres de alimentação de linha são removidos do argumento.

A chamada a seguir retorna o valor 1615198.

Val(" 1615 198th Street N.E.")   

A chamada a seguir retorna o valor decimal -1.

Val("&HFFFF")   

Observação

A Val função reconhece apenas o período (.) como um separador decimal válido. Quando diferentes separadores decimais são usados, como em aplicativos internacionais, use CDbl ou CInt , em vez disso, para converter uma cadeia de caracteres em um número. Para converter a representação de cadeia de caracteres de um número em uma cultura específica em um valor numérico, use o método do Parse(String, IFormatProvider) tipo numérico. Por exemplo, use Double.Parse ao converter uma cadeia de caracteres em um Double.

Uma InvalidCastException exceção pode ser gerada em resposta a determinados formatos de número incomuns. Por exemplo, o código a seguir gera essa exceção.

' These examples cause run-time errors.  
Console.WriteLine(Val("1.34%"))  
Console.WriteLine(Val("1.34&"))  

O conflito entre o número formatado como um Double e os Integer caracteres de tipo e Long seria capturado pelo compilador se ele não estivesse contido em uma cadeia de caracteres.

' These examples cause compiler errors.  
Dim m = 1.34%  
Dim n = 1.34&

Confira também

Aplica-se a

Val(String)

Origem:
Conversion.vb
Origem:
Conversion.vb
Origem:
Conversion.vb

Retorna os números contidos em uma cadeia de caracteres como um valor numérico do tipo apropriado.

public:
 static double Val(System::String ^ InputStr);
public static double Val (string? InputStr);
public static double Val (string InputStr);
static member Val : string -> double
Public Function Val (InputStr As String) As Double

Parâmetros

InputStr
String

Obrigatórios. Qualquer expressão String válida, variável Object ou valor Char. Se Expression for do tipo Object, seu valor deverá ser conversível para String ou um erro ArgumentException ocorrerá.

Retornos

Os números contidos em uma cadeia de caracteres como um valor numérico do tipo apropriado.

Exceções

InputStr é muito grande.

Expression é uma expressão de tipo Object não conversível para String.

Exemplos

O exemplo a seguir usa a Val função para retornar os números contidos em cada cadeia de caracteres. Val interrompe a conversão no primeiro caractere que não pode ser interpretado como um dígito numérico, modificador numérico, pontuação numérica ou espaço em branco.

Dim valResult As Double
' The following line of code sets valResult to 2457.
valResult = Val("2457")
' The following line of code sets valResult to 2457.
valResult = Val(" 2 45 7")
' The following line of code sets valResult to 24.
valResult = Val("24 and 57")

Comentários

A Val função para de ler a cadeia de caracteres no primeiro caractere que não pode reconhecer como parte de um número. Símbolos e caracteres que geralmente são considerados partes de valores numéricos, como cifrões e vírgulas, não são reconhecidos. No entanto, a função reconhece os prefixos &O radix (para octal) e &H (para hexadecimal). Espaços em branco, guias e caracteres de alimentação de linha são removidos do argumento.

A chamada a seguir retorna o valor 1234123.

Val(" 1234 123th Street N.E.")   

A chamada a seguir retorna o valor decimal -1.

Val("&HFFFF")   

Observação

A Val função reconhece apenas o período (.) como um separador decimal válido. Quando outros separadores decimais são usados, como em aplicativos internacionais, use CDbl ou CInt , em vez disso, para converter uma cadeia de caracteres em um número. Para converter a representação de cadeia de caracteres de um número em uma cultura específica em um valor numérico, use o método do Parse(String, IFormatProvider) tipo numérico. Por exemplo, use Double.Parse ao converter uma cadeia de caracteres em um Double.

Observação

Uma InvalidCastException exceção pode ser gerada em resposta a determinados formatos de número incomuns. Por exemplo, o código a seguir gera essa exceção.

' These examples cause run-time errors.

'Console.WriteLine(Val("1.34%"))

'Console.WriteLine(Val("1.34&"))

O conflito entre o número formatado como um Double e os Integer caracteres de tipo e Long será capturado pelo compilador se o conflito não estiver contido em cadeias de caracteres.

' These examples cause compiler errors.

'Dim m = 1.34%

'Dim n = 1.34&

Confira também

Aplica-se a