Opérateur DirectCast (Visual Basic)

  • Article

Introduit une opération de conversion de type basée sur l’héritage ou l’implémentation.

Notes

DirectCast n’utilise pas les routines d’assistance au moment de l’exécution de Visual Basic pour la conversion, de sorte qu’il peut fournir de meilleures performances que CType lors de la conversion vers et à partir du type de données Object.

Vous utilisez le mot clé DirectCast similaire à la façon dont vous utilisez la fonction CType et le mot clé de l’opérateur TryCast. Vous fournissez une expression comme premier argument et un type pour la convertir en tant que deuxième argument. DirectCast nécessite une relation d’héritage ou d’implémentation entre les types de données des deux arguments. Cela signifie qu’un type doit hériter ou implémenter l’autre type.

Erreurs et défaillances

DirectCast génère une erreur du compilateur s’il détecte qu’aucune relation d’héritage ou d’implémentation n’existe. Toutefois, l’absence d’erreur du compilateur ne garantit pas la réussite de la conversion. Si la conversion souhaitée est restrictive, elle peut échouer au moment de l’exécution. Si cela se produit, le runtime lève une erreur InvalidCastException.

Mots clés de conversion

Voici une comparaison des mots-clés de conversion de type.

Mot clé Types de données Relation d’argument Échec de l’exécution
CType Function Tous les types de données La conversion d’élargissement ou de réduction doit être définie entre les deux types de données Lève InvalidCastException
DirectCast Tous les types de données Un type doit hériter ou implémenter l’autre type Lève InvalidCastException
TryCast, opérateur Types de référence uniquement Un type doit hériter ou implémenter l’autre type Renvoie Nothing

Exemple

L’exemple suivant illustre deux utilisations de DirectCast, l’une qui échoue au moment de l’exécution et l’autre qui réussit.

Dim q As Object = 2.37
Dim i As Integer = CType(q, Integer)
' The following conversion fails at run time
Dim j As Integer = DirectCast(q, Integer)
Dim f As New System.Windows.Forms.Form
Dim c As System.Windows.Forms.Control
' The following conversion succeeds.
c = DirectCast(f, System.Windows.Forms.Control)

Dans l’exemple précédent, le type de runtime de q est Double. CType réussit, car Double peut être converti en Integer. Toutefois, le premier DirectCast échoue au moment de l’exécution, car le type de runtime de Double n’a aucune relation d’héritage avec Integer, même s’il existe une conversion. La seconde DirectCast réussit, car elle convertit de type Form en type Control, dont Form hérite.

Voir aussi