Funções de conversão de tipo Este é um conteúdo traduzido por máquina. Para exibir esta página em modo editável com o conteúdo original em inglês ao lado, clique em "Preferências" e escolha Clássica como sua preferência de exibição.

These functions are compiled inline, meaning the conversion code is part of the code that evaluates the expression.Sometimes there is no call to a procedure to accomplish the conversion, which improves performance.Each function coerces an expression to a specific data type.

Copiar

CBool(expression)CByte(expression)CChar(expression)CDate(expression)CDbl(expression)CDec(expression)CInt(expression)CLng(expression)CObj(expression)CSByte(expression)CShort(expression)CSng(expression)CStr(expression)CUInt(expression)CULng(expression)CUShort(expression)

Parte

expression

Obrigatório.Any expression of the source data type.

Return Value Data Type

The function name determines the data type of the value it returns, as shown in the following table.

Nome da função

Tipo de dado retonado

Intervalo para o argumento de expression

CBoolTipo de dados booleanos (Visual Basic)

Qualquer válido Char ou String ou numérico expressão.

CByteTipo de dados Byte (Visual Basic)

0 Através 255 (não assinado); partes fracionários são arredondados. 1

CCharCaractere tipo de dados (Visual Basic)

Qualquer válido Char ou String expressão: primeiro caractere de um String é convertido; valor pode ser 0 Através 65535 (não assinado).

CDate Tipo de dados Data (Visual

Any valid representation of a date and time.

Basic)

CDblTipo de dados duplo (Visual Basic)

-1.79769313486231570E+308 through -4.94065645841246544E-324 for negative values; 4.94065645841246544E-324 through 1.79769313486231570E+308 for positive values.

CDecTipo de dados decimais (Visual Basic)

+/-79,228,162,514,264,337,593,543,950,335 for zero-scaled numbers, that is, numbers with no decimal places.For numbers with 28 decimal places, the range is +/-7.9228162514264337593543950335.The smallest possible non-zero number is 0.0000000000000000000000000001 (+/-1E-28).

CIntTipo de Dados Inteiro (Visual Basic)

-2,147,483,648 através de 2,147,483,647; partes fracionários são arredondados. 1

CLngTipo de dados Long (Visual Basic)

-9.223.372.036.854.775.808 através de 9.223.372.036.854.775.807; partes fracionários são arredondados. 1

CObjTipo de dados Object

Any valid expression.

CSByteTipo de dado SByte (Visual Basic)

-128 através de 127; partes fracionários são arredondados. 1

CShortTipo de dados Short (Visual Basic)

-32.768 através de 32.767; partes fracionários são arredondados. 1

CSngTipo de dados único (Visual Basic)

-3.402823E+38 through -1.401298E-45 for negative values; 1.401298E-45 through 3.402823E+38 for positive values.

CStr

Tipo de dados de seqüência de caracteres (Visual Basic)

Retorna para CStr depende o argumento de expression.See Valores de Retorno para a Função CStr.

CUIntTipo de dados UInteger

0 Através 4.294.967.295 (não assinado); partes fracionários são arredondados. 1

CULngTipo de dados ULong (Visual Basic)

0 Através 18.446.744.073.709.551.615 (não assinado); partes fracionários são arredondados. 1

CUShortTipo de dados UShort (Visual Basic)

0 Através 65.535 (não assinado); partes fracionários são arredondados. 1

1 Fractional parts can be subject to a special type of rounding called banker's rounding.See "Remarks" for more information.

Comentários

Como regra, você deve usar as funções de conversão de tipo do Visual Basic em preferência aos métodos do .NET Framework, como ToString(), na classe Convert ou

em uma estrutura tipo individuais ou a classe.The Visual Basic functions are designed for optimal interaction with Visual Basic code, and they also make your source code shorter and easier to read.Além disso, os métodos de conversão do .NET Framework não produzem sempre os mesmos resultados como as funções Visual Basic, por exemplo ao converter Boolean em Integer.For more information, see Solucionando problemas de Tipos de Dados.

Comportamento

Coercion. In general, you can use the data type conversion functions to coerce the result of an operation to a particular data type rather than the default data type.Por exemplo, use CDec para forçar aritmética decimal em casos onde Simples-precisão, de precisão Duplo ou de aritmética de número inteiro normalmente levaria local.

Failed Conversions. Se o expression passado para a função está fora do intervalo do tipo de dados para o qual é a ser convertido, ocorre um OverflowException.

Fractional Parts. Quando você Convertere um valor nonintegral para um tipo integral, as funções de conversão de número inteiro (CByte, CInt, CLng, CSByte, CShort, CUInt, CULnge CUShort) remover a parte fracionária e arredondar o valor para o inteiro mais próximo.

If the fractional part is exactly 0.5, the integer conversion functions round it to the nearest even integer.Por exemplo, 0,5 arredonda para 0, 1,5 e 2.5 que ambos arredondar para 2.Isso é chamado de arredondamento Banker ' e sua finalidade é compensar uma inclinação que pode acumular ao adicionar muitos números juntos.

CInt e CLng diferir a Int, funções de correção (Visual Basic), que truncar, em vez de Arredondar, a parte fracionária de um número.Além disso, Fix e Int sempre retornam um valor do mesmo tipo de dados conforme você passa.

Date/Time Conversions. Use o Função de IsDate (Visual Basic) para determinar se um valor pode ser convertido em uma data e hora.CDate reconhece literais de data e literais de hora mas valores não numéricos.Para converter um valor de Date Visual Basic 6.0 a um valor de Date no Visual Basic 2005 ou posterior, você pode usar o método DateTime.FromOADate.

Neutral Date/Time Values. Sempre contém o Tipo de dados Data (Visual Basic) Ambos informações de data e hora.For purposes of type conversion, Visual Basic considers 1/1/0001 (January 1 of the year 1) to be a neutral value for the date, and 00:00:00 (midnight) to be a neutral value for the time.Se você converter um valor de Date em uma Cadeia de Caracteres, CStr não Incluir neutros valores a Cadeia de Caracteres resultante.For example, if you convert #January 1, 0001 9:30:00# to a string, the result is "9:30:00 AM"; the date information is suppressed.No entanto, a informação de data ainda está presente no valor Date original e pode ser recuperada com funções do tipo Função DatePart (Visual Basic).

Culture Sensitivity. The type conversion functions involving strings perform conversions based on the current culture settings for the application.Por exemplo, CDate reconhece formatos de data de acordo com à configuração de localidade do sistema.You must provide the day, month, and year in the correct

order for your locale, or the date might not be interpreted correctly.A long date format is not recognized if it contains a day-of-the-week string, such as "Wednesday".

If you need to convert to or from a string representation of a value in a format other than the one specified by your locale, you cannot use the Visual Basic type conversion functions.To do this, use the ToString(IFormatProvider) and Parse(String, IFormatProvider) methods of that value's type.Por exemplo, use Double.Parse ao converter uma Cadeia de Caracteres em um Doublee usar Double.ToString ao converter um valor de tipo Double em uma Cadeia de Caracteres.

CType Function

A função CType http://msdn.microsoft.com/pt-br/library/4x2877xb(v=VS.90).aspx leva um segundo argumento, typenamee converte no expression a typename, onde typename pode ser qualquer tipo de dados, estrutura, classe ou interface para o qual existe uma conversão válida.

Para uma comparação de CType com as outras conversão de tipos palavras-chave, consulte DirectCast e TryCast.

CBool Example

O exemplo a seguir utiliza a função CBool converter expressões para valores de Boolean.Se uma expressão for avaliada como um valor diferente de zero, CBool retorna True; Caso contrário, ela retornará False.

VBC#C++F#JScriptCopiarDim a, b, c As IntegerDim check As Booleana = 5b = 5' The following line of code sets check to True.check = CBool(a = b)c = 0' The following line of code sets check to False.check = CBool(c)

CByte Example

O exemplo a seguir utiliza a função CByte para converter uma expressão em um Byte.

VBC#

C++F#JScriptCopiarDim aDouble As DoubleDim aByte As ByteaDouble = 125.5678' The following line of code sets aByte to 126.aByte = CByte(aDouble)

CChar Example

O exemplo a seguir utiliza a função CChar para converter o primeiro caractere de uma expressão String em um tipo de Char.

VBC#C++F#JScriptCopiarDim aString As StringDim aChar As Char' CChar converts only the first character of the string.aString = "BCD"' The following line of code sets aChar to "B".aChar = CChar(aString)

O argumento de entrada para CChar deve ser de Tipo de Dados Char ou String.Você não pode usar CChar para converter um número em um caractere, como CChar não pode aceitar um tipo de dados numéricos.The following example obtains a number representing a code point (character code) and converts it to the corresponding character.Ele usa o Função   InputBox (Visual Basic)   para obter a seqüência de caracteres de dígitos, CInt para converter a cadeia de caracteres para tipo Integere ChrW para converter o número para tipo Char.

VBC#C++F#JScriptCopiarDim someDigits As StringDim codePoint As IntegerDim thisChar As CharsomeDigits = InputBox("Enter code point of character:")codePoint = CInt(someDigits)' The following line of code sets thisChar to the Char value of codePoint.thisChar = ChrW(codePoint)

CDate Example

O exemplo a seguir utiliza a função CDate para converter seqüências de caracteres em valores de Date.In general, hard-coding dates and times as strings (as shown in this example) is not recommended.Use date literals and time literals, such as #Feb 12, 1969# and #4:45:23 PM#, instead.

VBC#C++F#JScriptCopiarDim aDateString, aTimeString As StringDim aDate, aTime As DateaDateString = "February 12, 1969"aTimeString = "4:35:47 PM"' The following line of code sets aDate to a Date value.aDate = CDate(aDateString)' The following line of code sets aTime to Date value.aTime = CDate(aTimeString)

CDbl Example

VBC#C++F#JScriptCopiarDim aDec As DecimalDim aDbl As Double' The following line of code uses the literal type character D to make aDec a Decimal.aDec = 234.456784D' The following line of code sets aDbl to 1.9225456288E+1.aDbl = CDbl(aDec * 8.2D * 0.01D)

CDec Example

O exemplo a seguir usa a função CDec para converter um valor numérico para Decimal.

VBC#C++F#

JScriptCopiarDim aDouble As DoubleDim aDecimal As DecimalaDouble = 10000000.0587' The following line of code sets aDecimal to 10000000.0587.aDecimal = CDec(aDouble)

CInt Example

O exemplo a seguir utiliza a função CInt para converter um valor em Integer.

VBC#C++F#JScriptCopiarDim aDbl As DoubleDim anInt As IntegeraDbl = 2345.5678' The following line of code sets anInt to 2346.anInt = CInt(aDbl)

CLng Example

O exemplo a seguir utiliza a função CLng para converter valores em Long.

VBC#C++F#JScriptCopiarDim aDbl1, aDbl2 As DoubleDim aLng1, aLng2 As LongaDbl1 = 25427.45aDbl2 = 25427.55' The following line of code sets aLng1 to 25427.aLng1 = CLng(aDbl1)' The following line of code sets aLng2 to 25428.aLng2 = CLng(aDbl2)

CObj Example

O exemplo a seguir usa a função CObj para converter um valor numérico para Object.A variável Object próprio contém apenas um ponteiro de quatro bytes, que aponta para o valor de Double atribuída a ele.

VBC#C++F#JScriptCopiarDim aDouble As DoubleDim anObject As ObjectaDouble = 2.7182818284' The following line of code sets anObject to a pointer to aDouble.anObject = CObj(aDouble)

CSByte Example

O exemplo a seguir usa a função CSByte para converter um valor numérico para SByte.

VBC#C++F#JScriptCopiarDim aDouble As DoubleDim anSByte As SByteaDouble = 39.501' The following line of code sets anSByte to 40.anSByte = CSByte(aDouble)

CShort Example

O exemplo a seguir usa a função CShort para converter um valor numérico para Short.

VBC#C++F#JScriptCopiarDim aByte As ByteDim aShort As ShortaByte = 100' The following line of code sets aShort to 100.aShort = CShort(aByte)

CSng Example

O exemplo a seguir utiliza a função CSng para converter valores em Single.

VBC#C++F#JScriptCopiarDim aDouble1, aDouble2 As DoubleDim aSingle1, aSingle2 As SingleaDouble1 = 75.3421105aDouble2 = 75.3421567' The following line of code sets aSingle1 to 75.34211.aSingle1 = CSng(aDouble1)' The following line of code sets aSingle2 to 75.34216.aSingle2 = CSng(aDouble2)

CStr Example

O exemplo a seguir usa a função CStr para converter um valor numérico para String.

VBC#C++F#JScriptCopiarDim aDouble As DoubleDim aString As StringaDouble = 437.324' The following line of code sets aString to "437.324".aString = CStr(aDouble)

O exemplo a seguir usa a função CStr para converter valores DateString valores.

VBC#C++F#JScriptCopiarDim aDate As DateDim aString As String' The following line of code generates a COMPILER ERROR because of invalid format.' aDate = #February 12, 1969 00:00:00#' Date literals must be in the format #m/d/yyyy# or they are invalid.' The following line of code sets the time component of aDate to midnight.aDate = #2/12/1969#' The following conversion suppresses the neutral time value of 00:00:00.' The following line of code sets aString to "2/12/1969".

aString = CStr(aDate)' The following line of code sets the time component of aDate to one second past midnight.aDate = #2/12/1969 12:00:01 AM#' The time component becomes part of the converted value.' The following line of code sets aString to "2/12/1969 12:00:01 AM".aString = CStr(aDate)

CStr sempre apresenta um valor de Date no Formatarar padrão Abreviado para a localidade atual, por exemplo, "15 / / 2003 4:35:47 PM".No entanto, CStr suprime a valores neutro 1/1/0001 para a data e 00:00:00 para o tempo.

Para obter mais detalhes sobre os valores retornados pela CStr, consulte Valores de Retorno para a Função CStr.

CUInt Example

O exemplo a seguir usa a função CUInt para converter um valor numérico para UInteger.

VBC#C++F#JScriptCopiarDim aDouble As DoubleDim aUInteger As UIntegeraDouble = 39.501' The following line of code sets aUInteger to 40.aUInteger = CUInt(aDouble)

CULng Example

O exemplo a seguir usa a função CULng para converter um valor numérico para ULong.

VBC#C++F#JScriptCopiarDim aDouble As DoubleDim aULong As ULongaDouble = 39.501' The following line of code sets aULong to 40.aULong = CULng(aDouble)

CUShort Example

O exemplo a seguir usa a função CUShort para converter um valor numérico para UShort.

VBC#C++F#JScriptCopiarDim aDouble As DoubleDim aUShort As UShortaDouble = 39.501' The following line of code sets aUShort to 40.aUShort = CUShort(aDouble)

Consulte também

Referência

Funções de conversão (Visual Basic)Funções Asc, AscWFunções Chr, ChrWInt, funções de correção (Visual Basic)Função FormatFunção Hex (Visual Basic)Função OctFunção StrFunção Val

Outros recursos

Conversões de Tipo no Visu