Condividi tramite

Procedura: creare wrapper COM

È possibile creare wrapper COM (Component Object Model) usando le funzionalità di Visual Studio o gli strumenti .NET Framework Tlbimp.exe e Regasm.exe. Entrambi i metodi generano due tipi di wrapper COM:

  • Oggetto Runtime Callable Wrapper da una libreria dei tipi per l'esecuzione di un oggetto COM nel codice gestito.

  • Oggetto COM Callable Wrapper con le impostazioni del Registro di sistema richieste per l'esecuzione di un oggetto gestito in un'applicazione nativa.

In Visual Studio è possibile aggiungere il wrapper COM come riferimento al progetto.

Eseguire il wrapping di oggetti COM in un'applicazione gestita

Per creare un Runtime Callable Wrapper con Visual Studio

  1. Aprire il progetto per l'applicazione gestita.

  2. Scegliere Mostra tutti i file dal menu Progetto.

  3. Scegliere Aggiungi riferimento dal menu Progetto.

  4. Nella finestra di dialogo Aggiungi riferimento fare clic sulla scheda COM, selezionare il componente che si vuole usare e fare clic su OK.

    In Esplora soluzioni si noti che il componente COM viene aggiunto alla cartella Riferimenti nel progetto.

È ora possibile scrivere codice per accedere all'oggetto COM. È possibile iniziare dichiarando l'oggetto, ad esempio con un'istruzione Imports per Visual Basic o una Using direttiva per C#.

Nota

Per programmare componenti di Microsoft Office, installare innanzitutto il pacchetto ridistribuibile degli assembly di interoperabilità primari di Microsoft Office.

Per creare un Runtime Callable Wrapper con gli strumenti di .NET Framework

Questo strumento crea un assembly che contiene i metadati di runtime per i tipi definiti nella libreria dei tipi originale.

Eseguire il wrapping di oggetti gestiti in un'applicazione nativa

Per creare un COM Callable Wrapper con Visual Studio

  1. Creare un progetto libreria di classi per la classe gestita che si vuole eseguire in codice nativo. La classe deve avere un costruttore senza parametri.

    Verificare che l'assembly nel file AssemblyInfo abbia un numero di versione in quattro parti completo. Questo numero è obbligatorio per la gestione del controllo delle versioni nel Registro di sistema di Windows. Per altre informazioni sui numeri di versione, vedere Controllo delle versioni degli assembly.

  2. Scegliere Proprietà dal menu Progetto.

  3. Fare clic sulla scheda Compila.

  4. Selezionare la casella di controllo Registra per interoperabilità COM.

Quando si compila il progetto, l'assembly viene automaticamente registrato per l'interoperabilità COM. Se si compila un'applicazione nativa in Visual Studio, è possibile usare l'assembly scegliendo Aggiungi riferimento dal menu Progetto.

Per creare un COM Callable Wrapper con gli strumenti di .NET Framework

Eseguire lo strumento Regasm.exe (strumento di registrazione di assembly).

Questo strumento legge i metadati in un assembly e aggiunge le voci necessarie nel Registro di sistema. Di conseguenza, i client COM possono creare classi di .NET Framework in modo trasparente. È possibile usare l'assembly come se fosse una classe COM nativa.

È possibile eseguire Regasm.exe su un assembly disponibile in qualsiasi directory e quindi eseguire Gacutil.exe (strumento Global Assembly Cache) per spostarlo nella Global Assembly Cache. Lo spostamento dell'assembly non invalida le voci del Registro di sistema per la posizione, perché la Global Assembly Cache viene sempre esaminata se l'assembly non viene trovato in altre posizioni.

Vedi anche