Conversion.Val Método

Definição

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

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

Sobrecargas

Nome Description
Val(Object)

Retorna os números contidos em uma cadeia como um valor numérico do tipo apropriado.
Val(Char)

Retorna os números contidos em uma cadeia como um valor numérico do tipo apropriado.
Val(String)

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

Val(Object)

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

public:
 static double Val(System::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

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

Retornos

Double

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

Exceções

OverflowException

InputStr é muito grande.

ArgumentException

Expression é uma expressão Object de tipo que 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. Os símbolos e carateres que são frequentemente 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 converta 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 e do compilador seria capturado se o conflito não estivesse 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)

Retorna os números contidos em uma cadeia 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

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

Retornos

Int32

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

Exceções

OverflowException

InputStr é muito grande.

ArgumentException

Expression é uma expressão Object de tipo que 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. Os símbolos e carateres que são frequentemente 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). Os espaços em branco, os separadores e os carateres de linefeed 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 separadores decimais diferentes são usados, como em aplicativos internacionais, use CDbl ou CInt converta 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 e do compilador seria capturado 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)

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

public:
 static double Val(System::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

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

Retornos

Double

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

Exceções

OverflowException

InputStr é muito grande.

ArgumentException

Expression é uma expressão Object de tipo que 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. Os símbolos e carateres que são frequentemente 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 converta 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 e do compilador seria capturado se o conflito não estivesse contido em cadeias de caracteres.

' These examples cause compiler errors.

'Dim m = 1.34%

'Dim n = 1.34&

Confira também

Aplica-se a