Détection de la version CLR, exemple de technologie

Mise à jour : novembre 2007

Cet exemple indique comment détecter les versions du CLR (Common Language Runtime) du .NET Framework qui sont installées sur un ordinateur.

Pour plus d'informations sur l'utilisation des exemples, consultez les rubriques suivantes :

Download sample

Pour générer l'exemple à l'aide de Visual Studio

  1. Ouvrez l'Explorateur Windows et accédez au sous-répertoire CP dans le répertoire CLRVerSample.

  2. Double-cliquez sur l'icône du fichier CLRVerCP.sln pour l'ouvrir dans Visual Studio 2005.

  3. Dans le menu Générer, cliquez sur Générer la solution.

Pour exécuter l'exemple

  1. Dans la fenêtre d'invite de commandes, accédez au répertoire qui contient le nouveau fichier exécutable.

  2. Tapez CLRVer.exe à la ligne de commande.

Configuration requise

Version .Net Framework : 2.0, 1.1

Microsoft Visual Studio 2005

Ces exemples requièrent des en-têtes Windows qui sont disponibles pour votre projet si vous les générez à l'aide de Microsoft Visual Studio 2005 ou de l'invite de commandes de Visual Studio 2005, ou si le Kit de développement Platform SDK (en anglais) est installé et spécifié dans un chemin d'accès Include.

Notes

Cet exemple est disponible uniquement en C++. L'exemple de code appelle des API non managées définies dans mscoree.h, qui figure dans le sous-répertoire \include de votre répertoire d'installation du Kit de développement logiciel (SDK) Windows, afin de répertorier les versions du CLR installées sur l'ordinateur local.

Cet exemple appelle la méthode GetRequestedRuntimeInfo, fonction non managée qui retourne des informations sur la version du CLR chargée dans le processus. Ces informations ne présentent pas toujours la dernière version du CLR installée sur l'ordinateur.

Dans la version 2.0 du .NET Framework, vous pouvez obtenir la dernière version installée du CLR en spécifiant les éléments suivants pour les paramètres GetRequestedRuntimeInfo, fonction :

  • Affectez la valeur null aux trois premiers paramètres.

  • Spécifiez l'indicateur RUNTIME_INFO_UPGRADE_VERSION dans les énumérations RUNTIME_INFO_FLAGS définies pour le paramètre runtimeInfoFlags.

Il se peut que la méthode GetRequestedRuntimeInfo, fonction ne retourne pas la dernière version du CLR dans les cas suivants :

  • S'il existe un fichier de configuration de l'application qui spécifie le chargement d'une version du CLR particulière. Notez que le .NET Framework utilisera le fichier de configuration même si vous spécifiez null pour le paramètre pConfigurationFile.

  • Si l'appel CorBindToRuntimeEx, fonction a été réalisé spécifiant une version antérieure du CLR.

  • Si une application qui a été compilée pour une version antérieure du CLR est en cours d'exécution.

Voir aussi

Concepts

Hôtes de runtime

Référence

GetCORVersion, fonction

Autres ressources

Hébergement du Common Language Runtime

Référence des API non managées