CType (Función) (Visual Basic)
Devuelve el resultado de convertir explícitamente una expresión a un tipo de datos, objeto, estructura, clase o interfaz.
CType(expression, typename)
Partes
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
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, no se produce ninguna llamada a un procedimiento para llevar a cabo la conversión, lo que acelera la ejecució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. Esto puede pasar, por ejemplo, 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
Si está trabajando con objetos dinámicos, en los que las conversiones dinámicas definidas por el usuario que utilizan el método BindConvert o TryConvert realizan conversiones de tipos, utilice el método 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 especificado.
Dim testNumber As Long = 1000
' The following line of code sets testNewType to 1000.0.
Dim testNewType As Single = CType(testNumber, Single)
Vea también
Tareas
Cómo: Definir un operador de conversión (Visual Basic)
Referencia
Funciones de conversión de tipos (Visual Basic)