Procedura: creare wrapper COM
Aggiornamento: novembre 2007
È possibile creare wrapper COM (Component Object Model) utilizzando le funzionalità di Microsoft Visual Studio 2005 o gli strumenti di .NET Framework Tlbimp.exe e Regasm.exe. Entrambi i metodi generano due tipi di wrapper COM:
Un Runtime Callable Wrapper da una libreria di tipi per eseguire un oggetto COM nel codice gestito.
Un COM Callable Wrapper con le impostazioni del Registro di sistema richieste per eseguire un oggetto gestito in un'applicazione nativa.
In Visual Studio 2005 è possibile aggiungere il wrapper COM come riferimento al progetto.
Wrapping di oggetti COM in un'applicazione gestita
Per creare un Runtime Callable Wrapper utilizzando Visual Studio
Aprire il progetto per l'applicazione gestita.
Scegliere Mostra tutti i file dal menu Progetto.
Scegliere Aggiungi riferimento dal menu Progetto.
Nella finestra di dialogo Aggiungi riferimento fare clic sulla scheda COM, selezionare il componente che si desidera utilizzare e scegliere OK.
In Esplora soluzioni verificare che il componente COM sia stato aggiunto nella 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 2005 o con un'istruzione Using per Visual C# 2005.
.gif "Nota") Nota: |
|---|
Se si desidera programmare i componenti Microsoft Office, installare innanzitutto gli Assembly di interoperabilità primari di Microsoft Office (informazioni in lingua inglese) dall'Area download Microsoft. Nel passaggio 4 selezionare la versione più recente della libreria di oggetti disponibile per il prodotto Office desiderato, ad esempio Libreria oggetti di Microsoft Word 11.0. Per gli esempi, vedere Esempio di tecnologia Microsoft Word e Esempio di tecnologia Microsoft Excel. |
Per creare un Runtime Callable Wrapper utilizzando gli strumenti di .NET Framework
- Eseguire lo strumento Utilità di importazione della libreria dei tipi (Tlbimp.exe).
Questo strumento crea un assembly contenente metadati di runtime per i tipi definiti nella libreria di tipi originale.
Wrapping di oggetti gestiti in un'applicazione nativa
Per creare un COM Callable Wrapper utilizzando Visual Studio
Creare un progetto Libreria di classi per la classe gestita che si desidera eseguire nel codice nativo. La classe deve disporre di un costruttore predefinito.
Verificare che nel file AssemblyInfo sia contenuto un numero di versione in quattro parti completo. Questo numero è obbligatorio per gestire il controllo delle versioni nel Registro di sistema di Windows. Per ulteriori informazioni sui numeri di versione, vedere Controllo delle versioni degli assembly.
Scegliere Proprietà dal menu Progetto.
Fare clic sulla scheda Compila.
Selezionare la casella di controllo Registra per interoperabilità COM.
Quando si genera il progetto, l'assembly viene registrato automaticamente per l'interoperabilità COM. Se si genera un'applicazione nativa in Visual Studio 2005, è possibile utilizzare l'assembly scegliendo Aggiungi riferimento dal menu Progetto.
Per creare un COM Callable Wrapper utilizzando gli strumenti di .NET Framework
- Eseguire lo strumento Strumento di registrazione degli assembly (Regasm.exe).
Questo strumento legge i metadati dell'assembly e aggiunge le voci necessarie nel Registro di sistema. I client COM possono pertanto creare classi .NET Framework in modo trasparente. È possibile utilizzare l'assembly come se fosse una classe COM nativa.
È possibile eseguire Regasm.exe su un assembly contenuto in qualsiasi directory e quindi eseguire lo Strumento Global Assembly Cache (Gacutil.exe) per spostarlo nella Global Assembly Cache. Lo spostamento dell'assembly non invalida le voci del Registro di sistema relative al percorso, poiché viene sempre esaminata la Global Assembly Cache se l'assembly non viene trovato altrove.