Conversion.Val Método

Definição

Devolve os números contidos numa cadeia como um valor numérico de um tipo determinado.

Sobrecargas

Name Description
Val(Object)

Devolve os números contidos numa cadeia como um valor numérico de um tipo determinado.

Val(Char)

Devolve os números contidos numa cadeia como um valor numérico de um tipo determinado.

Val(String)

Devolve os números contidos numa cadeia como um valor numérico de um tipo determinado.

Val(Object)

Devolve os números contidos numa cadeia como um valor numérico de um tipo determinado.

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, o seu valor deve ser convertível para String ou ocorre um ArgumentException erro.

Devoluções

Os números contidos numa cadeia como um valor numérico do tipo apropriado.

Exceções

InputStr é demasiado grande.

Expression é uma Object expressão de tipo que não é convertível em String.

Exemplos

O exemplo seguinte usa a Val função para devolver os números contidos em cada cadeia. Val para de converter no primeiro carácter que não pode ser interpretado como 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")

Observações

A Val função deixa de ler a cadeia no primeiro carácter que não consegue 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, tabulações e caracteres de sair de linha são removidos do argumento.

A chamada seguinte devolve o valor 1234123.

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

A chamada seguinte devolve o valor decimal -1.

Val("&HFFFF")

Note

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

Note

Pode ser feita uma InvalidCastException exceção em resposta a certos formatos numéricos pouco comuns. Por exemplo, o código seguinte levanta esta 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 a Double e os Integer caracteres tipo e Long seria detetado pelo compilador se o conflito não estivesse contido em cadeias de caracteres.

' These examples cause compiler errors.

'Dim m = 1.34%

'Dim n = 1.34&

Ver também

Aplica-se a

Val(Char)

Devolve os números contidos numa cadeia como um valor numérico de um tipo determinado.

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, o seu valor deve ser convertível para String ou ocorre um ArgumentException erro.

Devoluções

Os números contidos numa cadeia como um valor numérico do tipo apropriado.

Exceções

InputStr é demasiado grande.

Expression é uma Object expressão de tipo que não é convertível em String.

Exemplos

O exemplo seguinte usa a Val função para devolver os números contidos em cada cadeia. Val para de converter no primeiro carácter que não pode ser interpretado como 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")

Observações

A Val função deixa de ler a cadeia no primeiro carácter que não consegue 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 seguinte devolve o valor 1615198.

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

A chamada seguinte devolve o valor decimal -1.

Val("&HFFFF")

Note

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

Pode ser feita uma InvalidCastException exceção em resposta a certos formatos numéricos pouco comuns. Por exemplo, o código seguinte levanta esta 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 a Double e os Integer caracteres do tipo e Long seria detetado pelo compilador se não estivesse contido numa cadeia.

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

Ver também

Aplica-se a

Val(String)

Devolve os números contidos numa cadeia como um valor numérico de um tipo determinado.

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, o seu valor deve ser convertível para String ou ocorre um ArgumentException erro.

Devoluções

Os números contidos numa cadeia como um valor numérico do tipo apropriado.

Exceções

InputStr é demasiado grande.

Expression é uma Object expressão de tipo que não é convertível em String.

Exemplos

O exemplo seguinte usa a Val função para devolver os números contidos em cada cadeia. Val para de converter no primeiro carácter que não pode ser interpretado como 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")

Observações

A Val função deixa de ler a cadeia no primeiro carácter que não consegue 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, tabulações e caracteres de sair de linha são removidos do argumento.

A chamada seguinte devolve o valor 1234123.

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

A chamada seguinte devolve o valor decimal -1.

Val("&HFFFF")

Note

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

Note

Pode haver uma InvalidCastException exceção em resposta a certos formatos numéricos pouco comuns. Por exemplo, o código seguinte levanta esta 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 a Double e os Integer caracteres tipo e Long seria detetado pelo compilador se o conflito não estivesse contido em cadeias de caracteres.

' These examples cause compiler errors.

'Dim m = 1.34%

'Dim n = 1.34&

Ver também

Aplica-se a