Vorgehensweise: Erstellen von COM-Wrappern

  • Artikel

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

  • Ein Runtime Callable Wrapper aus einer Typbibliothek führt ein COM-Objekt in verwaltetem Code aus.

  • Ein COM Callable Wrapper mit den erforderlichen Registrierungseinstellungen führt ein verwaltetes Objekt in einer nativen Anwendung aus.

In Visual Studio können Sie den COM-Wrapper als Verweis zu Ihrem Projekt hinzufügen.

Umschließen von COM-Objekten in einer verwalteten Anwendung

Erstellen eines durch die Laufzeit aufrufbaren Wrappers mit Visual Studio

  1. Öffnen Sie das Projekt für Ihre 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 Komponente aus, die Sie verwenden möchten, und klicken Sie auf OK.

    Beachten Sie, dass die COM-Komponente im Projektmappen-Explorer dem Projektordner „Verweise“ 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 oder einer Using-Anweisung für C#.

Hinweis

Wenn Sie Microsoft Office-Komponenten programmieren möchten, installieren Sie zunächst das Redistributable für primäre Interop-Assemblys von Microsoft Office.

Erstellen eines Runtime Callable Wrappers mit .NET Framework-Tools

Dieses Tool erstellt eine Assembly, die Laufzeitmetadaten für die Typen enthält, die in der ursprünglichen Typbibliothek definiert wurden.

Umschließen von verwalteten Objekten in einer nativen Anwendung

Erstellen eines COM Callable Wrappers mit Visual Studio

  1. Erstellen Sie ein Klassenbibliotheksprojekt für die verwaltete Klasse, die Sie in nativem Code ausführen möchten. Die Klasse muss einen parameterlosen Konstruktor haben.

    Ü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 über die Versionsummern 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 für COM-Interop automatisch registriert. Wenn Sie in Visual Studio eine native Anwendung erstellen, können Sie die Assembly verwenden, indem Sie im Menü Projekt auf Verweis hinzufügen klicken.

Erstellen eines COM Callable Wrappers mit .NET Framework-Tools

Führen Sie das Tool Regasm.exe (Assembly Registration-Tool) aus.

Dieses Tool liest die Metadaten in einer Assembly und fügt der Registrierung die notwendigen Einträge hinzu. Folglich können COM-Clients .NET Framework-Klassen transparent erstellen. Sie können die Assembly verwenden, als handle es sich um eine native COM-Klasse.

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 nicht an einem anderen Speicherort gefunden wird.

Siehe auch