Gewusst wie: Erstellen von COM-Wrappern
Aktualisiert: November 2007
Sie können COM-Wrapper (Component Object Model) erstellen, indem Sie Microsoft Visual Studio 2005-Features oder die .NET Framework-Tools Tlbimp.exe und Regasm.exe verwenden. Bei beiden Methoden werden zwei Typen von COM-Wrappern erzeugt:
Ein Runtime Callable Wrapper (RCW) aus einer Typbibliothek, um ein COM-Objekt in verwaltetem Code auszuführen.
Ein COM Callable Wrapper (CCW) mit den erforderlichen Registrierungseinstellungen, um ein verwaltetes Objekt in einer systemeigenen Anwendung auszuführen.
In Visual Studio 2005 können Sie dem Projekt den COM-Wrapper als Verweis hinzufügen.
Einbinden von COM-Objekten in eine verwaltete Anwendung
So erstellen Sie einen Runtime Callable Wrapper mit Visual Studio
Öffnen Sie das Projekt für die verwaltete Anwendung.
Klicken Sie im Menü Projekt auf Alle Dateien anzeigen.
Klicken Sie im Menü Projekt auf Verweis hinzufügen.
Klicken Sie im Dialogfeld Verweis hinzufügen auf die Registerkarte COM, wählen Sie die gewünschte Komponente, und klicken Sie anschließend auf OK.
Beachten Sie, dass im Projektmappen-Explorer dem Ordner Verweise des Projekts die COM-Komponente hinzugefügt wird.
Sie können jetzt Code schreiben, um auf das COM-Objekt zuzugreifen. Sie können mit dem Deklarieren des Objekts beginnen, zum Beispiel mit einer Imports-Anweisung für Visual Basic 2005 oder einer Using-Anweisung für Visual C# 2005.
.gif "Hinweis") Hinweis: |
|---|
Wenn Sie Microsoft Office-Komponenten programmieren möchten, installieren Sie zunächst die primären Interop-Assemblys (PIAs), die im Microsoft Download Center unter Microsoft Office Primary Interop Assemblies verfügbar sind. Wählen Sie in Schritt 4 die aktuelle Version der Objektbibliothek, die für das gewünschte Office-Produkt zur Verfügung steht, z. B. Microsoft Word 11.0-Objektbibliothek. Beispiele finden Sie unter Microsoft Word-Technologiebeispiel und Microsoft Excel-Technologiebeispiel. |
So erstellen Sie einen Runtime Callable Wrapper mit .NET Framework-Tools
- Führen Sie das Type Library Importer-Tool (Tlbimp.exe)-Tool aus.
Dieses Tool erstellt eine Assembly, die Laufzeitmetadaten für die Typen enthält, die in der ursprünglichen Typbibliothek definiert wurden.
Einbinden von verwalteten Objekten in einer systemeigenen Anwendung
So erstellen Sie einen COM Callable Wrapper mit Visual Studio
Erstellen Sie ein Klassenbibliotheksprojekt für die verwaltete Klasse, die Sie in systemeigenem Code ausführen möchten. Die Klasse muss über einen Standardkonstruktor verfügen.
Überprüfen Sie, ob Sie eine vollständige vierteilige Versionsnummer für die Assembly in der AssemblyInfo-Datei besitzen. Diese Zahl ist für die Versionszuweisung in der Windows-Registrierung erforderlich. Weitere Informationen zu Versionsnummern finden Sie unter Assemblyversionen.
Klicken Sie im Menü Projekt auf Eigenschaften.
Klicken Sie auf die Registerkarte Kompilieren.
Aktivieren Sie das Kontrollkästchen Für COM-Interop registrieren.
Wenn Sie das Projekt erstellen, wird die Assembly automatisch für COM-Interop registriert. Wenn Sie eine systemeigene Anwendung in Visual Studio 2005 erstellen, können Sie die Assembly verwenden, indem Sie im Menü Projekt auf Verweis hinzufügen klicken.
So erstellen Sie einen COM Callable Wrapper mit .NET Framework-Tools
- Führen Sie das Assembly Registration-Tool (Regasm.exe)-Tool aus.
Dieses Tool liest die Assemblymetadaten und fügt der Registrierung die notwendigen Einträge hinzu. So können COM-Clients .NET Framework-Klassen transparent erstellen. Sie können die Assembly wie eine systemeigene COM-Klasse verwenden.
Sie können Regasm.exe für eine Assembly in jedem beliebigen Verzeichnis ausführen und anschließend das Global Assembly Cache-Tool (Gacutil.exe) ausführen, um sie in den globalen Assemblycache zu verschieben. Beim Verschieben der Assembly werden die Registrierungseinträge für den Speicherort nicht ungültig, da der globale Assemblycache immer überprüft wird, wenn die Assembly an einem anderen Speicherort nicht gefunden wird.