Conversion.Val Método

Definição

Retorna os números contidos em uma cadeia de caracteres como um valor numérico do tipo apropriado.Returns the numbers contained in a string as a numeric value of appropriate type.

Sobrecargas

Val(Object)

Retorna os números contidos em uma cadeia de caracteres como um valor numérico do tipo apropriado.Returns the numbers contained in a string as a numeric value of appropriate type.

Val(Char)

Retorna os números contidos em uma cadeia de caracteres como um valor numérico do tipo apropriado.Returns the numbers contained in a string as a numeric value of appropriate type.

Val(String)

Retorna os números contidos em uma cadeia de caracteres como um valor numérico do tipo apropriado.Returns the numbers contained in a string as a numeric value of appropriate type.

Val(Object)

Retorna os números contidos em uma cadeia de caracteres como um valor numérico do tipo apropriado.Returns the numbers contained in a string as a numeric value of appropriate type.

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

Obrigatório.Required. Qualquer expressão String válida, variável Object ou valor Char.Any valid String expression, Object variable, or Char value. Se Expression for do tipo Object, seu valor deverá ser conversível para String ou um erro ArgumentException ocorrerá.If Expression is of type Object, its value must be convertible to String or an ArgumentException error occurs.

Retornos

Os números contidos em uma cadeia de caracteres como um valor numérico do tipo apropriado.The numbers contained in a string as a numeric value of appropriate type.

Exceções

InputStr é muito grande.InputStr is too large.

Expression é uma expressão de tipo Object não conversível para String.Expression is an Object type expression that is not convertible to String.

Exemplos

O exemplo a seguir usa a função Val para retornar os números contidos em cada cadeia de caracteres.The following example uses the Val function to return the numbers contained in each string. Val para de converter no primeiro caractere que não pode ser interpretado como dígito numérico, modificador numérico, pontuação numérica ou espaço em branco.Val stops converting at the first character that cannot be interpreted as a numeric digit, numeric modifier, numeric punctuation, or white space.

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 função Val para de ler a cadeia de caracteres no primeiro caractere que ela não pode reconhecer como parte de um número.The Val function stops reading the string at the first character it cannot recognize as part of a number. Símbolos e caracteres que geralmente são considerados partes de valores numéricos, como sinais de dólar e vírgulas, não são reconhecidos.Symbols and characters that are often considered parts of numeric values, such as dollar signs and commas, are not recognized. No entanto, a função reconhece os prefixos de Radix &O (para octal) e &H (para hexadecimal).However, the function recognizes the radix prefixes &O (for octal) and &H (for hexadecimal). Espaços em branco, tabulações e caracteres de avanço de alimentação são removidos do argumento.Blanks, tabs, and linefeed characters are removed from the argument.

A chamada a seguir retorna o valor 1234123.The following call returns the value 1234123.

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

A chamada a seguir retorna o valor decimal-1.The following call returns the decimal value -1.

Val("&HFFFF")   

Observação

A função Val reconhece apenas o período (.) como um separador decimal válido.The Val function recognizes only the period (.) as a valid decimal separator. Quando outros separadores decimais são usados, como em aplicativos internacionais, use CDbl ou CInt em vez de converter uma cadeia de caracteres em um número.When other decimal separators are used, as in international applications, use CDbl or CInt instead to convert a string to a number. 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 de Parse(String, IFormatProvider) do tipo numeric.To convert the string representation of a number in a particular culture to a numeric value, use the numeric type's Parse(String, IFormatProvider) method. Por exemplo, use Double.Parse ao converter uma cadeia de caracteres em um Double.For example, use Double.Parse when converting a string to a Double.

Observação

Uma exceção InvalidCastException pode ser lançada em resposta a determinados formatos de número incomuns.An InvalidCastException exception might be thrown in response to certain uncommon number formats. Por exemplo, o código a seguir gera essa exceção.For example, the following code raises this exception.

' 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 caracteres de tipo Integer e Long seriam capturados pelo compilador se o conflito não estiver contido em cadeias de caractere.The conflict between the number formatted as a Double and the Integer and Long type characters would be caught by the compiler if the conflict were not contained in strings.

' These examples cause compiler errors.

'Dim m = 1.34%

'Dim n = 1.34&

Veja também

Val(Char)

Retorna os números contidos em uma cadeia de caracteres como um valor numérico do tipo apropriado.Returns the numbers contained in a string as a numeric value of appropriate type.

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ório.Required. Qualquer expressão String válida, variável Object ou valor Char.Any valid String expression, Object variable, or Char value. Se Expression for do tipo Object, seu valor deverá ser conversível para String ou um erro ArgumentException ocorrerá.If Expression is of type Object, its value must be convertible to String or an ArgumentException error occurs.

Retornos

Os números contidos em uma cadeia de caracteres como um valor numérico do tipo apropriado.The numbers contained in a string as a numeric value of appropriate type.

Exceções

InputStr é muito grande.InputStr is too large.

Expression é uma expressão de tipo Object não conversível para String.Expression is an Object type expression that is not convertible to String.

Exemplos

O exemplo a seguir usa a função Val para retornar os números contidos em cada cadeia de caracteres.The following example uses the Val function to return the numbers contained in each string. Val para de converter no primeiro caractere que não pode ser interpretado como dígito numérico, modificador numérico, pontuação numérica ou espaço em branco.Val stops converting at the first character that cannot be interpreted as a numeric digit, numeric modifier, numeric punctuation, or white space.

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 função Val para de ler a cadeia de caracteres no primeiro caractere que ela não pode reconhecer como parte de um número.The Val function stops reading the string at the first character it cannot recognize as part of a number. Símbolos e caracteres que geralmente são considerados partes de valores numéricos, como sinais de dólar e vírgulas, não são reconhecidos.Symbols and characters that are often considered parts of numeric values, such as dollar signs and commas, are not recognized. No entanto, a função reconhece os prefixos de Radix &O (para octal) e &H (para hexadecimal).However, the function recognizes the radix prefixes &O (for octal) and &H (for hexadecimal). Espaços em branco, tabulações e caracteres de avanço de alimentação são removidos do argumento.Blanks, tabs, and linefeed characters are stripped from the argument.

A chamada a seguir retorna o valor 1615198.The following call returns the value 1615198.

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

A chamada a seguir retorna o valor decimal-1.The following call returns the decimal value -1.

Val("&HFFFF")   

Observação

A função Val reconhece apenas o período (.) como um separador decimal válido.The Val function recognizes only the period (.) as a valid decimal separator. Quando separadores de decimais diferentes são usados, como em aplicativos internacionais, use CDbl ou CInt em vez de converter uma cadeia de caracteres em um número.When different decimal separators are used, as in international applications, use CDbl or CInt instead to convert a string to a number. 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 de Parse(String, IFormatProvider) do tipo numeric.To convert the string representation of a number in a particular culture to a numeric value, use the numeric type's Parse(String, IFormatProvider) method. Por exemplo, use Double.Parse ao converter uma cadeia de caracteres em um Double.For example, use Double.Parse when converting a string to a Double.

Uma exceção InvalidCastException pode ser lançada em resposta a determinados formatos de número incomuns.An InvalidCastException exception might be thrown in response to certain uncommon number formats. Por exemplo, o código a seguir gera essa exceção.For example, the following code raises this exception.

' 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 caracteres de tipo Integer e Long seriam capturados pelo compilador se ele não estivesse contido em uma cadeia de caracteres.The conflict between the number formatted as a Double and the Integer and Long type characters would be caught by the compiler if it were not contained in a string.

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

Veja também

Val(String)

Retorna os números contidos em uma cadeia de caracteres como um valor numérico do tipo apropriado.Returns the numbers contained in a string as a numeric value of appropriate type.

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

Obrigatório.Required. Qualquer expressão String válida, variável Object ou valor Char.Any valid String expression, Object variable, or Char value. Se Expression for do tipo Object, seu valor deverá ser conversível para String ou um erro ArgumentException ocorrerá.If Expression is of type Object, its value must be convertible to String or an ArgumentException error occurs.

Retornos

Os números contidos em uma cadeia de caracteres como um valor numérico do tipo apropriado.The numbers contained in a string as a numeric value of appropriate type.

Exceções

InputStr é muito grande.InputStr is too large.

Expression é uma expressão de tipo Object não conversível para String.Expression is an Object type expression that is not convertible to String.

Exemplos

O exemplo a seguir usa a função Val para retornar os números contidos em cada cadeia de caracteres.The following example uses the Val function to return the numbers contained in each string. Val para de converter no primeiro caractere que não pode ser interpretado como dígito numérico, modificador numérico, pontuação numérica ou espaço em branco.Val stops converting at the first character that cannot be interpreted as a numeric digit, numeric modifier, numeric punctuation, or white space.

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 função Val para de ler a cadeia de caracteres no primeiro caractere que ela não pode reconhecer como parte de um número.The Val function stops reading the string at the first character it cannot recognize as part of a number. Símbolos e caracteres que geralmente são considerados partes de valores numéricos, como sinais de dólar e vírgulas, não são reconhecidos.Symbols and characters that are often considered parts of numeric values, such as dollar signs and commas, are not recognized. No entanto, a função reconhece os prefixos de Radix &O (para octal) e &H (para hexadecimal).However, the function recognizes the radix prefixes &O (for octal) and &H (for hexadecimal). Espaços em branco, tabulações e caracteres de avanço de alimentação são removidos do argumento.Blanks, tabs, and linefeed characters are removed from the argument.

A chamada a seguir retorna o valor 1234123.The following call returns the value 1234123.

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

A chamada a seguir retorna o valor decimal-1.The following call returns the decimal value -1.

Val("&HFFFF")   

Observação

A função Val reconhece apenas o período (.) como um separador decimal válido.The Val function recognizes only the period (.) as a valid decimal separator. Quando outros separadores decimais são usados, como em aplicativos internacionais, use CDbl ou CInt em vez de converter uma cadeia de caracteres em um número.When other decimal separators are used, as in international applications, use CDbl or CInt instead to convert a string to a number. 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 de Parse(String, IFormatProvider) do tipo numeric.To convert the string representation of a number in a particular culture to a numeric value, use the numeric type's Parse(String, IFormatProvider) method. Por exemplo, use Double.Parse ao converter uma cadeia de caracteres em um Double.For example, use Double.Parse when converting a string to a Double.

Observação

Uma exceção de InvalidCastException pode ser gerada em resposta a determinados formatos de número incomuns.An InvalidCastException exception might be raised in response to certain uncommon number formats. Por exemplo, o código a seguir gera essa exceção.For example, the following code raises this exception.

' 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 caracteres de tipo Integer e Long seriam capturados pelo compilador se o conflito não estiver contido em cadeias de caractere.The conflict between the number formatted as a Double and the Integer and Long type characters would be caught by the compiler if the conflict were not contained in strings.

' These examples cause compiler errors.

'Dim m = 1.34%

'Dim n = 1.34&

Veja também

Aplica-se a