Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

Conversion explicite de type : (T)expression

L’expression `(T)expression` convertit explicitement le résultat de `expression` vers le type `T`. Elle peut effectuer une conversion numérique ou de référence, un déboxing ou une conversion définie par l’utilisateur. La réussite n’est pas garantie : des données peuvent être perdues ou une exception peut être levée.

Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntaxe

(T)expression

L’expression (T)expression demande une conversion explicite : T est le type cible et expression fournit la valeur à convertir. Un cast peut également demander une conversion disponible implicitement. S’il n’existe aucune conversion applicable, le compilateur rejette le code ; ajouter (T) ne permet pas de convertir arbitrairement des types entre eux.

Les conversions numériques peuvent entraîner une perte d’information. Pour un double fini dont la partie entière tient dans un int, (int)value supprime la partie fractionnaire en allant vers zéro : -12.75 devient -12, et non -13. Lors d’une conversion réductrice entre types entiers en contexte checked, la conversion lève OverflowException si la valeur obtenue à l’exécution est hors de la plage du type cible. Si l’opérande est une expression constante dont la valeur est hors de cette plage, la conversion en contexte checked provoque une erreur de compilation, comme dans checked((byte)256). En contexte unchecked, une telle conversion réductrice supprime les bits excédentaires. Ne généralisez pas cette règle à toutes les conversions numériques.

Une conversion de référence ne modifie ni l’objet ni son type à l’exécution. Caster un objet incompatible peut lever InvalidCastException ; caster une référence null vers un type référence produit toujours null. Si la référence source n’est pas null, le déboxing exige une valeur boxée du type approprié : si boxed contient un int, (long)boxed lève InvalidCastException, mais (long)(int)boxed déballe d’abord le int, puis le convertit en long. Le déboxing d’une référence null vers un type valeur nullable donne null : par exemple, (int?)(object)null produit null de type int? sans qu’aucune valeur ne soit boxée.

Contrairement à un cast, is vérifie la compatibilité, tandis que as renvoie null en cas d’incompatibilité et ne prend pas en charge les conversions numériques ou définies par l’utilisateur. Un type peut définir les opérateurs de conversion implicit et explicit utilisés par les casts ; il ne peut pas surcharger () lui-même. L’exemple illustre la troncature de la partie fractionnaire, le déboxing suivi d’un élargissement et une conversion de référence.

Exemples

using System;

internal static class Program
{
    private static void Main()
    {
        double value = -12.75;
        int whole = (int)value;
        Console.WriteLine(whole);

        object boxed = 42;
        long widened = (long)(int)boxed;
        Console.WriteLine(widened);

        object text = "hello";
        string word = (string)text;
        Console.WriteLine(word.Length);
    }
}

Résultat

-12
42
5

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources