Exécution côte à côte in-process

Article
08/10/2011

À partir de .NET Framework version 4, vous pouvez utiliser l'hébergement côte à côte in-process pour exécuter plusieurs versions du Common Language Runtime (CLR) sous la forme d'un processus unique. Par défaut, les composants COM managés s'exécutent avec la version du .NET Framework avec laquelle ils ont été construits, indépendamment de la version du .NET Framework chargée pour le processus.

Background

Le .NET Framework a toujours fourni un hébergement côte à côte pour les applications de code managé, mais avant le .NET Framework 4, il ne fournissait pas cette fonctionnalité pour les composants COM managés. Dans le passé, les composants COM managés chargés dans un processus étaient exécutés avec la version du runtime déjà chargée ou avec la version installée la plus récente du .NET Framework. Si cette version n'était pas compatible avec le composant COM, le composant échouait.

Le .NET Framework 4 fournit une nouvelle approche de l'hébergement côte à côte qui s'assure des éléments suivants :

L'installation d'une nouvelle version du .NET Framework n'a aucun effet sur les applications existantes.
Les applications sont exécutées par rapport à la version du .NET Framework avec laquelle elles ont été construites. Elles n'utilisent pas la nouvelle version du .NET Framework, à moins que cela leur ait été expressément demandé. Il est toutefois plus facile pour les applications de passer à une nouvelle version du .NET Framework.

Effets sur les utilisateurs et les développeurs

Utilisateurs finaux et administrateurs systèmes. Ces utilisateurs savent désormais que lorsqu'ils installent une nouvelle version du runtime, soit indépendamment soit avec une application, cela n'aura aucun impact sur leurs ordinateurs. Les applications existantes continueront à fonctionner comme auparavant.
Développeurs d'applications. L'hébergement côte à côte n'a presque aucun effet sur les développeurs d'applications. Par défaut, les applications sont toujours exécutées sur la version du .NET Framework sur laquelle elles ont été créées. Cela n'a pas changé. Toutefois, les développeurs peuvent substituer ce comportement et demander à l'application de s'exécuter sous une version plus récente du .NET Framework (consultez le scénario 2).
Consommateurs et développeurs de bibliothèques. L'hébergement côte à côte ne résout pas les problèmes de compatibilité rencontrés par les développeurs de bibliothèques. Une bibliothèque chargée directement par une application, soit via une référence directe soit via un appel Assembly.Load, continue d'utiliser le runtime du AppDomain dans lequel elle est chargée. Vous devez tester vos bibliothèques sur toutes les versions du .NET Framework que vous souhaitez prendre en charge. Si une application est compilée à l'aide du runtime .NET Framework 4 mais inclut une bibliothèque créée à l'aide d'un runtime antérieur, cette bibliothèque utilisera également le runtime .NET Framework 4. Toutefois, si vous possédez une application générée à l'aide d'un runtime antérieure et une bibliothèque créée à l'aide du .NET Framework 4, vous devez forcer votre application à utiliser également le .NET Framework 4 (consultez le scénario 3).
Développeurs de composants COM managés. Dans le passé, les composants COM managés étaient exécutés automatiquement à l'aide de la version la plus récente du runtime installé sur l'ordinateur. Vous pouvez maintenant exécuter les composants COM sur la version du runtime avec laquelle ils ont été créés.

Comme indiqué par le tableau suivant, les composants construits avec le .NET Framework version 1.1 peuvent s'exécuter côte à côte avec les composants de la version 4, mais ils ne peuvent pas s'exécuter avec les composants de la version 2.0, 3.0 ou 3.5, car l'hébergement côte à côte n'est pas disponible pour ces versions.

Version du .NET Framework

1.1

2.0 - 3.5

4

1.1

Non applicable

Non

Oui

2.0 - 3.5

Non

Non applicable

Oui

4

Oui

Oui

Non applicable

Version du .NET Framework	1.1	2.0 - 3.5	4
1.1	Non applicable	Non	Oui
2.0 - 3.5	Non	Non applicable	Oui
4	Oui	Oui	Non applicable

Remarque
Les versions 3.0 et 3.5 du .NET Framework sont générées de façon incrémentielle sur la version 2.0 et n'ont pas besoin de fonctionner côte à côte.Il s'agit fondamentalement de la même version.

Scénarios d'hébergement côte à côte courants

Scénario 1 : application native qui utilise des composants COM créés avec des versions antérieures du .NET Framework.

Versions du .NET Framework installées : .NET Framework 4 et toutes les autres versions du .NET Framework utilisées par les composants COM.

Que faire : dans ce scénario, ne faites rien. Les composants COM s'exécuteront avec la version du .NET Framework avec laquelle ils ont été inscrits.
Scénario 2 : application managée créée avec le .NET Framework 2.0 SP1 que vous préféreriez voir fonctionner avec le .NET Framework version 2.0, mais que vous voulez bien exécuter sur le .NET Framework 4 si la version 2.0 est absente.

Versions du .NET Framework installées : une version antérieure du .NET Framework et le .NET Framework 4.

Que faire : dans le fichier de configuration de l'application dans le répertoire de l'application, utilisez l'élément <startup> et l'élément <supportedRuntime> comme suit :
```
<configuration>
  <startup >
    <supportedRuntime version="v2.0.50727" />
    <supportedRuntime version="v4.0" />
  </startup>
</configuration>
```
Scénario 3 : application native qui utilise des composants COM créés avec des versions antérieures du .NET Framework que vous souhaitez exécuter avec le .NET Framework 4.

Versions du .NET Framework installées : .NET Framework 4.

Que faire : dans le fichier de configuration de l'application, dans le répertoire de l'application, utilisez l'élément <startup> avec l'attribut useLegacyV2RuntimeActivationPolicy défini sur true et l'élément <supportedRuntime> défini comme suit :
```
<configuration>
  <startup useLegacyV2RuntimeActivationPolicy="true">
    <supportedRuntime version="v4.0" />
  </startup>
</configuration>
```

Exemple

L'exemple suivant montre un hôte COM non managé qui exécute un composant COM managé à l'aide de la version du .NET Framework que le composant a été compilé pour utiliser.

Pour exécuter l'exemple suivant, compilez et inscrivez le composant COM managé suivant à l'aide de .NET Framework version 3.5. Pour inscrire le composant, dans le menu Projet, cliquez sur Properties, cliquez sur l'onglet Générer, puis activez la case à cocher Inscrire pour COM interop.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Runtime.InteropServices;

namespace BasicComObject
{
    [ComVisible(true), Guid("9C99C4B5-CA54-4c58-8988-49B6811BA53B")]
    public class MyObject : SimpleObjectModel.IPrintInfo
    {
        public MyObject()
        {
        }
        public void PrintInfo()
        {
            Console.WriteLine("MyObject was activated in {0} runtime in:\n\tAppDomain {1}:{2}", System.Runtime.InteropServices.RuntimeEnvironment.GetSystemVersion(), AppDomain.CurrentDomain.Id, AppDomain.CurrentDomain.FriendlyName);
        }
    }
}

Compilez l'application C++ non managée suivante, ce qui active l'objet COM créé par l'exemple précédent.

#include "stdafx.h"
#include <string>
#include <iostream>
#include <objbase.h>
#include <string.h>
#include <process.h>

using namespace std;

int _tmain(int argc, _TCHAR* argv[])
{
    char input;
    CoInitialize(NULL) ;
    CLSID clsid;
    HRESULT hr;
    HRESULT clsidhr = CLSIDFromString(L"{9C99C4B5-CA54-4c58-8988-49B6811BA53B}",&clsid);
    hr = -1;
    if (FAILED(clsidhr))
    {
        printf("Failed to construct CLSID from String\n");
    }
    UUID id = __uuidof(IUnknown);
    IUnknown * pUnk = NULL;
    hr = ::CoCreateInstance(clsid,NULL,CLSCTX_INPROC_SERVER,id,(void **) &pUnk);
    if (FAILED(hr))
    {
        printf("Failed CoCreateInstance\n");
    }else
    {
        pUnk->AddRef();
        printf("Succeeded\n");
    }

    DISPID dispid;
    IDispatch* pPrintInfo;
    pUnk->QueryInterface(IID_IDispatch, (void**)&pPrintInfo);
    OLECHAR FAR* szMethod[1];
    szMethod[0]=OLESTR("PrintInfo"); 
    hr = pPrintInfo->GetIDsOfNames(IID_NULL,szMethod, 1, LOCALE_SYSTEM_DEFAULT, &dispid);
    DISPPARAMS dispparams;
    dispparams.cNamedArgs = 0;
    dispparams.cArgs = 0;
    VARIANTARG* pvarg = NULL;
    EXCEPINFO * pexcepinfo = NULL;
    WORD wFlags = DISPATCH_METHOD ;
;
    LPVARIANT pvRet = NULL;
    UINT * pnArgErr = NULL;
    hr = pPrintInfo->Invoke(dispid,IID_NULL, LOCALE_USER_DEFAULT, wFlags,
        &dispparams, pvRet, pexcepinfo, pnArgErr);
    printf("Press Enter to exit");
    scanf_s("%c",&input);
    CoUninitialize();
    return 0;
}

Voir aussi

Référence

<startup>, élément

<supportedRuntime>, élément

Historique des modifications

Date	Historique	Motif
Août 2010	Numéro de version corrigé pour .NET Framework 2.0 dans le fichier de configuration de l'application.	Commentaires client.

Août 2010

Numéro de version corrigé pour .NET Framework 2.0 dans le fichier de configuration de l'application.

Commentaires client.