CType, fonction
Mise à jour : novembre 2007
Retourne le résultat d'une conversion explicite d'une expression en un type de données, objet, structure, classe ou interface spécifié.
CType(expression, typename)
Éléments
expression
Toute expression valide. Si la valeur de expression se trouve en dehors de la plage autorisée par typename, Visual Basic lève une exception.typename
Toute expression valide au sein d'une clause As d'une instruction Dim, c'est-à-dire le nom de tout type de données, objet, structure, classe ou interface.
Notes
CType est compilé "inline", c'est-à-dire que le code de conversion fait partie du code qui évalue l'expression. Il arrive qu'une conversion soit réalisée sans aucun appel à une procédure, rendant ainsi l'exécution plus rapide.
Si aucune conversion n'est définie de expression à typename, par exemple de Integer à Date, Visual Basic affiche un message d'erreur de compilation.
Si une conversion échoue au moment de l'exécution, l'exception appropriée se produit. Si une conversion restrictive échoue, le résultat le plus courant est un OverflowException. Si la conversion n'est pas définie, un InvalidCastException se produit. Par exemple, cela peut arriver si expression est de type Object et que son type d'exécution n'a aucune conversion en typename.
Si le type de données de expression ou typename est une classe ou structure que vous avez définie, vous pouvez définir CType comme opérateur de conversion sur cette classe ou structure. Ainsi, CType agit comme un opérateur surchargé. En faisant ceci, vous pouvez contrôler le comportement des conversions effectuées vers et à partir de votre classe ou structure, y compris les exceptions pouvant être levées.
Surcharge
L'opérateur CType peut également être surchargé sur une classe ou structure définie en dehors de votre code. Si votre code convertit vers et à partir d'une telle classe ou structure, assurez-vous d'avoir bien compris le comportement de son opérateur CType. Pour plus d'informations, consultez Procédures d'opérateur.
Exemple
L'exemple suivant utilise la fonction CType pour convertir une expression en un type de données spécifié.
Dim testNumber As Long = 1000
' The following line of code sets testNewType to 1000.0.
Dim testNewType As Single = CType(testNumber, Single)
Voir aussi
Tâches
Comment : définir un opérateur de conversion
Référence
Fonctions de conversion de types de données