Compartilhar via


Função CType (Visual Basic)

Retorna o resultado da conversão explícita de uma expressão em um tipo de dados, objeto, classe ou interface especificada.

CType(expression, typename)

Partes

  • expression
    Qualquer expressão válida.Se o valor de expression está fora do intervalo permitido por typename, o Visual Basic gera uma exceção.

  • typename
    Qualquer expressão que é legal dentro de uma cláusula de As em uma instrução de Dim , isto é, o nome de qualquer tipo de dados, objeto, classe, estrutura ou interface.

Comentários

DicaDica

Você também pode usar as seguintes funções para executar uma conversão de tipos:

CType in-line é compilado, 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 chamada para um procedimento para realizar a conversão, que faz a execução mais rápida.

Se nenhuma conversão é definida de expression a typename (por exemplo, Integer da Date), o Visual Basic exibe uma mensagem de erro em tempo de compilação.

Se uma conversão falhar em tempo de execução, a exceção apropriado é lançada.Se uma conversão redutora falhar, OverflowException é mais comum de resultado.Se a conversão é indefinida, no InvalidCastException lançada.Por exemplo, isso pode acontecer se expression é do tipo Object e seu tipo de tempo de execução não tem nenhuma conversão a typename.

Se o tipo de dados de expression ou de typename é uma classe ou estrutura que você definiu, você pode definir CType na classe ou estrutura como um operador de conversão.Isso faz CType atuar como um operador sobrecarregado.Se você fizer isso, você pode controlar o comportamento das conversões para e sua classe ou estrutura, incluindo as exceções que podem ser geradas.

Sobrecarga

O operador de CType também pode ser sobrecarregado em uma classe ou estrutura definidos fora do seu código.Se seu código converte para ou de uma classe ou estrutura, esteja certo que entende o comportamento do operador de CType .Para obter mais informações, consulte Procedimentos de operador (Visual Basic).

Convertendo objetos dinâmicos

Conversões de tipos de objetos dinâmicos são executadas pela conversões dinâmicos definidos pelo usuário que usam os métodos de TryConvert ou de BindConvert .Se você estiver trabalhando com objetos dinâmicos, use o método de CTypeDynamic para converter o objeto dinâmico.

Exemplo

O exemplo a seguir usa a função para converter CType de uma expressão para o 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)

Para exemplos adicionais, consulte Conversões implícitas e explícitas (Visual Basic).

Consulte também

Tarefas

Como: definir um operador de conversão (Visual Basic)

Referência

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

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

OverflowException

InvalidCastException

Instrução Operator

Conceitos

Digite a conversão na.NET Framework