Esempio relativo alle tecnologie per la costruzione di oggetti
Aggiornamento: novembre 2007
In questo esempio viene illustrato come utilizzare le stringhe per la costruzione di oggetti in un ambiente .NET. Si tratta di stringhe di inizializzazione che è possibile specificare o modificare mediante lo strumento di amministrazione Servizi componenti, senza dover impostare come hardcoded le informazioni di configurazione all'interno dei componenti. L'interfaccia utente dell'esempio è costituita da un form con un solo pulsante, che consente di creare un oggetto mediante stringhe di costruzione. Nelle finestre di messaggio vengono visualizzate le varie fasi di attivazione.
Per informazioni sull'utilizzo degli esempi, vedere i seguenti argomenti:
Per generare l'esempio utilizzando il prompt dei comandi
Aprire la finestra del prompt dei comandi, quindi spostarsi in una delle sottodirectory specifiche del linguaggio della directory Technologies\ComponentServices\ObjectConstruction.
Digitare msbuild ObjectConstructionCS.sln o msbuild ObjectConstructionVB.sln, a seconda del linguaggio di programmazione che si desidera utilizzare.
Per generare l'esempio utilizzando Visual Studio
Aprire Esplora risorse, quindi spostarsi in una delle sottodirectory specifiche del linguaggio della directory Technologies\ComponentServices\ObjectConstruction.
Fare doppio clic sull'icona relativa a ObjectConstructionCS.sln o ObjectConstructionVB.sln, a seconda del linguaggio di programmazione che si desidera utilizzare, per aprire il file in Visual Studio.
Scegliere Build Solution dal menu Build.
Per eseguire l’esempio
Aprire la finestra del prompt dei comandi o Esplora risorse, quindi spostarsi nella directory contenente il file eseguibile generato.
Digitare OCDemo.exe dalla riga di comando oppure fare doppio clic sul file eseguibile in Esplora risorse per avviarlo. Prestare attenzione alla versione dell'applicazione di esempio, ossia C# (nella sottodirectory \CS) o Visual Basic (nella sottodirectory \VB). In base alla versione eseguita verranno determinati gli attributi dei componenti COM+ da modificare a livello amministrativo in uno dei passaggi successivi.
Quando il programma viene avviato, fare clic sul pulsante Create Object. Verrà visualizzata una finestra di messaggio in ciascuna fase dell'attivazione. Si noti il valore della stringa per la costruzione dell'oggetto indicato nella chiamata a IObjectConstruct::Construct.
Avviare lo strumento di amministrazione Servizi componenti facendo clic sul pulsante Start e scegliendo Tutti i programmi, Strumenti di amministrazione e Servizi componenti, quindi individuare l'applicazione COM+ OCDemoSvr espandendo la struttura Servizi componenti\Computer\Risorse del computer\Applicazioni COM+ nel riquadro sinistro della finestra di esplorazione.
Individuare il componente Microsoft.Samples.Technologies.ComponentServices.ObjectConstruction.ObjectConstructionTest espandendo la struttura OCDemoSvr\Componenti.
Fare clic con il pulsante destro del mouse sul componente ObjectConstructionTest, quindi scegliere Properties dal menu di scelta rapida.
Fare clic sulla scheda Activation, quindi immettere un nuovo valore nel campo di modifica Stringa costruttore. Scegliere OK per confermare la modifica.
Tornare all'applicazione OCDemo, quindi fare nuovamente clic su Create Object. Si noti il nuovo valore indicato dal metodo IObjectConstruct. Questo valore dovrebbe corrispondere alla stringa modificata nella pagina delle proprietà del componente nella finestra di esplorazione COM+.
Per disinstallare l'esempio
Spostarsi nella directory in cui è stato eseguito il file msbuild.exe o è stato aperto il file sln.
Dalla riga di comando digitare msbuild.exe ObjectConstructionVB.sln /t:Clean o msbuild.exe ObjectConstructionCS.sln /t:Clean, a seconda del linguaggio di programmazione che si desidera utilizzare. In questo modo vengono chiamati lo Strumento di installazione dei servizi .NET (Regsvcs.exe) e lo Strumento Global Assembly Cache (Gacutil.exe) con l'opzione /u per rimuovere i file di esempio dal catalogo COM+ e dalla Global Assembly Cache.
Requisiti
Piattaforma: Windows 2000, Windows XP, Windows Server 2003
Versione di .NET Framework: 2.0, 1.1, 1.0
Osservazioni
Per ulteriori informazioni sulle fasi di registrazione e creazione di file binari di esempio, vedere i commenti nei file di codice sorgente.
In questa procedura viene illustrato come creare un componente COM+ con la funzionalità per la costruzione di oggetti attivata e utilizzando una stringa di costruzione predefinita. Durante la creazione di un'istanza di un oggetto, i vari metodi del componente visualizzano finestre di messaggio per indicare l'ordine delle chiamate. La stringa per la costruzione dell'oggetto viene modificata mediante lo strumento di amministrazione Servizi componenti e l'esempio viene eseguito nuovamente per verificare se la stringa passata all'istanza del componente è stata modificata.
.gif "Nota") Nota: |
|---|
Prima di eseguire l'esempio, è necessario utilizzare lo Strumento Global Assembly Cache (Gacutil.exe) per installare l'assembly OCDemoSvr.dll nella Global Assembly Cache. Lo strumento Gacutil.exe si trova nella directory SDK\<versione>\Bin. Ad esempio, se è stata compilata la versione Visual Basic dell'applicazione, spostarsi nella directory C:\Documents and Settings\nome utente\Documenti\Samples\Technologies\ComponentServices\ObjectConstruction\VB, quindi digitare gacutil -i OCDemoSvr.dll. |
Il nome del componente visualizzato nello strumento di amministrazione Servizi componenti è Microsoft.Samples.Technologies.ComponentServices.ObjectConstruction.ObjectConstructionTest.
Quando la funzionalità per la costruzione di oggetti è attivata per un componente, COM+ chiama e implementa il metodo IObjectContruct::Construct immediatamente dopo la creazione di un'istanza dell'oggetto. La stringa per la costruzione dell'oggetto specificata nelle proprietà relative all'attivazione del componente viene passata come argomento al metodo. Questo comportamento, insieme al codice del componente che utilizza la stringa relativa all'oggetto, consente la costruzione dell'oggetto con parametri.
È possibile specificare un valore predefinito per la stringa di costruzione nella proprietà predefinita di ConstructionEnabledAttribute, nel catalogo COM+ oppure in entrambi.
Questa funzionalità può essere utilizzata da uno sviluppatore per creare un componente in cui sia inclusa una connessione ODBC generica. In questo caso, la stringa per la costruzione di oggetti conterrà un nome origine dati specifico che potrà essere modificato mediante lo strumento di amministrazione Servizi componenti.
Le stringhe per la costruzione di oggetti possono risultare utili in combinazione con i servizi di pool di oggetti COM+.
Vedere anche
Concetti
Utilizzo di tipi COM nel codice gestito
Riferimenti
Strumento Global Assembly Cache (Gacutil.exe)