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

SugerenciaSugerencia

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 no hay llamadas a un procedimiento de para realizar la conversión, que crea la ejecución más rápida.

Si no se define ninguna conversión de expression a typename (por ejemplo, de Integer a Date), Visual Basic mostrará un mensaje de error en tiempo de compilación.

Si una conversión produce errores en tiempo de ejecución, se produce una excepción adecuada.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 undefined, InvalidCastException en se produce.Por ejemplo, esto puede suceder si expression es de Object escrito y su tipo en tiempo de ejecución no tiene ninguna conversión a typename.

Si el tipo de datos de expression o de typename es una clase o estructura que haya definido, puede definir CType en esa clase o estructura como un operador de conversión.Esto hace que CType actúe como un operador sobrecargado.Si lo hace, puede controlar el comportamiento de conversiones entre la clase o estructura, incluidas las excepciones que pueden iniciarse.

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 realiza conversiones dinámicas definido por el usuario que utilizan los métodos de TryConvert o de 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 especificado.

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