Share via


CType Function

Retorna o resultado da conversão explicitamente uma expressão para um tipo de dados especificado, objeto, estrutura, classe ou interface.

CType(expression, typename)

Partes

  • expression
    Any valid expression.Se o valor de expression está fora do intervalo permitido pelo typenameVisual Basic lança uma exceção.

  • typename
    Qualquer expressão que é válido dentro de um As cláusula em um Dim demonstrativo, isto é, o nome de qualquer tipo de dados, objeto, estrutura, classe ou interface.

Comentários

CType é compilada embutidas, o que significa que o código de conversão é parte do código que avalia a expressão. Em alguns casos não há nenhuma telefonar para um procedimento para realizar a conversão, o que torna a execução rápida.

Se nenhuma conversão é definido de expression para typename, por exemplo de Integer para DateVisual Basic exibe uma mensagem de erro em time de compilar.

Se uma conversão falhar em time de execução, a exceção adequada ocorre.Se uma restrição conversão falhar, um OverflowException é o resultado mais comuns. Se a conversão estiver indefinida, um InvalidCastException ocorre. Isso pode acontecer, por exemplo, se expression é do tipo Object e seu tipo de time de execução não tem nenhuma conversão para typename.

Se o tipo de dados de expression ou typename é uma classe ou estrutura foram definidos, você pode definir CType nessa classe ou estrutura sistema autônomo um operador de conversão. Isso torna o CType atuar sistema autônomo um operador sobrecarregado.Se você fizer isso, você pode controlar o comportamento de conversões para e de sua classe ou estrutura, incluindo quais exceções podem ser geradas.

Sobrecarga

The CType operador também pode ser sobrecarregado em uma classe ou estrutura definida fora de seu código. Se seu código converte para ou de tal classe ou estrutura, certifique-se de que compreender o comportamento do seu CType operador. Para obter mais informações, consulte Procedimentos de Operador.

Exemplo

O exemplo a seguir utiliza o CType função para converter uma expressão no tipo de dados especificado.

Dim testNumber As Long = 1000
' The following line of code sets testNewType to 1000.0.
Dim testNewType As Single = CType(testNumber, Single)

Consulte também

Tarefas

Como: Define a Conversion operador

Referência

Funções de conversão de tipo 

Funções de conversão (Visual Basic)

OverflowException

InvalidCastException

Declaração Operator