Gewusst wie: Erstellen von COM-Wrappern

Sie können COM-Wrapper (Component Object Model) mit Microsoft Visual Studio 2005-Funktionen oder den .NET Framework-Tools Tlbimp.exe und Regasm.exe erstellen. Beide Methoden generieren zwei Typen von COM-Wrappern:

• 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 den COM-Wrapper dem Projekt als Verweis hinzufügen.

Umschließen von COM-Objekten in einer verwalteten Anwendung

So erstellen Sie einen Runtime Callable Wrapper mit Visual Studio

1. Öffnen Sie das Projekt für die verwaltete Anwendung.

2. Klicken Sie im Menü Projekt auf Alle Dateien anzeigen.

3. Klicken Sie im Menü Projekt auf Verweis hinzufügen.

4. 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 der Objektdeklaration beginnen, zum Beispiel mit einer Imports-Anweisung für Visual Basic 2005 oder einer Using-Anweisung für Visual C# 2005.

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.Microsoft Excel Technology Sample

So erstellen Sie einen Runtime Callable Wrapper mit .NET Framework-Tools

• Führen Sie das Tlbimp.exe (Type Library Importer-Tool)-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

1. 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.

2. Klicken Sie im Menü Projekt auf Eigenschaften.

3. Klicken Sie auf die Registerkarte Kompilieren.

4. 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 in Visual Studio 2005 eine systemeigene Anwendung 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 Regasm.exe (Assembly Registration-Tool)-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 Gacutil.exe (Global Assembly Cache-Tool) 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.

Siehe auch

Konzepte

Runtime Callable Wrapper (RCW)

COM Callable Wrapper (CCW)