Compartir a través de


CType (Función) (Visual Basic)

Devuelve el resultado de convertir explícitamente una expresión en un tipo de datos, objeto, estructura, clase o interfaz especificados.

CType(expression, typename)

Elementos

  • expression
    Cualquier expresión válida. Si el valor de expression está fuera del intervalo permitido por typename, Visual Basic produce una excepción.

  • typename
    Cualquier expresión válida dentro de una cláusula As de una instrucción Dim, es decir, el nombre de cualquier tipo de datos, objeto, estructura, clase o interfaz.

Comentarios

Sugerencia

También puede utilizar las siguientes funciones para realizar una conversión de tipos:

CType se compila en línea, es decir, el código de conversión forma parte del código que evalúa la expresión. En algunos casos, el código se ejecuta con mayor rapidez porque no se llama a los procedimientos para realizar la conversión.

Si no se ha definido ninguna conversión de expression a typename, (por ejemplo, de Integer a Date), Visual Basic muestra un mensaje de error de compilación.

Si en una conversión se produce un error en tiempo de ejecución, se produce la excepción correspondiente. Si se produce un error en una conversión de restricción, OverflowException es el resultado más común. Si la conversión es indefinida, se produce una excepción InvalidCastException. Por ejemplo, esto puede pasar si expression es de tipo Object y su tipo en tiempo de ejecución no tiene ninguna conversión a typename.

Si el tipo de datos de expression o typename es una clase o estructura que ha definido, puede definir CType en dicha clase o estructura como un operador de conversión. Esto hace que CType actúe como un operador sobrecargado. De este modo, puede controlar el comportamiento de las conversiones que tienen como destino o como origen la clase o estructura, incluidas las excepciones que se pueden producir.

Sobrecarga

El operador CType también se puede sobrecargar en una clase o la estructura definida fuera del código. Si el código realiza conversiones que tienen como destino o como origen una clase o estructura de este tipo, asegúrese de conocer el comportamiento de su operador CType. Para obtener más información, vea Procedimientos de operador (Visual Basic).

Convertir objetos dinámicos

Las conversiones de tipos de objetos dinámicos se realizan mediante conversiones dinámicas definidas por el usuario que utilizan los métodos TryConvert o BindConvert . Si está trabajando con objetos dinámicos, utilice el método de CTypeDynamic para convertir el objeto dinámico.

Ejemplo

En el ejemplo siguiente se utiliza la función CType para convertir una expresión al tipo de datos Single.

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

Para obtener otros ejemplos, vea Conversiones implícita y explícita (Visual Basic).

Vea también

Tareas

Cómo: Definir un operador de conversión (Visual Basic)

Referencia

Funciones de conversión de tipos (Visual Basic)

Funciones de conversión (Visual Basic)

OverflowException

InvalidCastException

Operator (Instrucción)

Conceptos

Conversión de tipos en .NET Framework