Prise en charge des assemblages d'interopérabilité principaux pour les objets d'automatisation

Les objets d'automatisation exposés par HCLZ and I Emulator for Windows peuvent être utilisés par des applications écrites dans n’importe quel langage ciblant le framework .NET. Les applications .NET gérées peuvent programmer Z and I Emulator for Windows en utilisant les assemblages d'intéropérabilité principaux (PIA) qui encapsulent les objets d'automatisation. Les assemblages d’interopérabilité sont le mécanisme par lequel les applications gérées (.NET) utilisent des objets compatibles COM. Les assemblages d’interopérabilité contiennent des informations de liaison et de métadonnées, qui permettent au framework .NET (CLR) de charger ou de rassembler des objets COM et de les encapsuler pour les applications .NET. Le PIA contient la description officielle des types COM tels que définis par l'éditeur de ces types COM. Le PIA est toujours signé numériquement par l'éditeur du type COM original.

Il existe deux manières pour une application .NET de référencer un assemblage.
  • S'il s'agit d'une application simple ou de la seule application qui utilise l'assemblage, Microsoft recommande que l'assemblage soit copié dans le même répertoire que l'application.
  • Si plusieurs applications font référence à l'assemblage, vous pouvez les installer dans le Global Assembly Cache (GAC) et faire en sorte que toutes les solutions référencent l'assemblage dans le GAC.

Le modèle de programmation des types exposés par les assemblage d'intéropérabilité est très similaire à COM. Les méthodes, propriétés et événements exposés par l'objet COM sont accessibles par n'importe quel langage .NET, en utilisant la syntaxe du langage. Un exemple d'application (ECLSamps.net) écrit en C# est fourni dans le répertoire \samples de l'image d'installation de Z and I Emulator for Windows. L’exemple illustre l’utilisation simple de différents types d’assemblages d’interopérabilité.

Pour les projets Visual Basic 6.0 qui utilisent les objets d'automatisation Z and I Emulator for Windows et ont été migrés vers Visual Basic .NET à l'aide de l'assistant de conversion, il vous suffit de remplacer les références générées implicitement par l'assistant de conversion avec les références Z and I Emulator for Windows Interop correspondantes (à partir du répertoire \Interops) et recompilez. La façon de remplacer les références consiste à supprimer toutes les références générées par l’assistant de conversion et à utiliser Visual Studio .NET pour ajouter les références d’interopérabilité .NET. Si vous avez enregistré les assemblages dans le GAC et souhaitez les utiliser, ajoutez les références et définissez la propriété Copy Local pour les références Z and I Emulator for Windows Interop sur False.

Les PIA pour les objets d'automatisation de l'émulateur Z and I Emulator for Windows sont installés dans le répertoire \Interops de l'image d'installation de Z and I Emulator for Windows. Si le programme d'installation du produit Z and I Emulator for Windows détecte que le framework .NET est présent, il vous donne la possibilité supplémentaire d'enregistrer les types dans le GAC. Lors de l'installation des assemblages dans le GAC, les PIA seront également placés dans le registre, sous la clé de registre de la bibliothèque de types correspondante.

Assemblages d'interopérabilité principaux pour les objets d'automatisation Z and I Emulator for Windows répertorie les PIA fournis pour les objets d'automatisation Z and I Emulator for Windows

Table 1. Assemblages d'interopérabilité principaux pour les objets d'automatisation Z and I Emulator for Windows
Objet d'automatisation Dépendance de l'assemblage d'interopérabilité
autECLConnList Interop.AutConnListTypeLibrary.dll
autECLConnMgr Interop.AutConnMgrTypeLibrary.dll
autECLConnList Interop.AutPSTypeLibrary.dll
autECLOIA Interop.AutOIATypeLibrary.dll
autECLPS Interop.AutPSTypeLibrary.dll
autECLScreenDesc Interop.AutScreenDescTypeLibrary.dll
autECLScreenReco Interop.AutScreenRecoTypeLibrary.dll
autECLSession Interop.AutSessTypeLibrary.dll
autECLPageSettings Interop.AutSettingsTypeLibrary.dll
autECLPrinterSettings Interop.AutSettingsTypeLibrary.dll
autECLWinMetrics Interop.AutWinMetricsTypeLibrary.dll
autECLXfer Interop.AutXferTypeLibrary.dll
autSystem Interop.AutSystemTypeLibrary.dll