Procedura: creare wrapper COM
È 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.
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.
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.Microsoft Excel Technology Sample |
- Eseguire lo strumento Tlbimp.exe (utilità di importazione della libreria dei tipi).
Questo strumento crea un assembly contenente metadati di runtime per i tipi definiti nella libreria di tipi originale.
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 compila il progetto, l'assembly viene registrato automaticamente per l'interoperabilità COM. Se si compila un'applicazione nativa in Visual Studio 2005, è possibile utilizzare l'assembly scegliendo Aggiungi riferimento dal menu Progetto.
- Eseguire lo strumento Regasm.exe (strumento di registrazione di assembly).
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 Gacutil.exe (strumento Global Assembly Cache) 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.