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:
-
La conversión de tipos funciona como CByte, CDbl y CInt que realizan una conversión a un tipo de datos específico.Para obtener más información, vea Funciones de conversión de tipos (Visual Basic).
-
DirectCast (Operador) (Visual Basic) o TryCast (Operador) (Visual Basic).Estos operadores requieren que un tipo se herede o implemente en otro tipo.Pueden proporcionar un mejor rendimiento que CType al convertir al tipo de datos de Object.
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)