Generare un client WCF o un contratto di servizio WCF per gli artefatti della soluzione Oracle Database
È possibile usare il plug-in Add Adapter Service Reference di Visual Studio per generare una classe client WCF o un contratto di servizio WCF (interfaccia) destinato alle operazioni selezionate sugli artefatti del database Oracle. È anche possibile usare lo strumento utilità metadati ServiceModel (svcutil.exe) per generare la classe client WCF o il contratto di servizio WCF; Tuttavia, il plug-in Aggiungi riferimento al servizio adapter espone la funzionalità dello strumento utilità metadati ServiceModel tramite un'interfaccia standard di Microsoft Windows. Fornisce anche funzionalità di esplorazione e ricerca non disponibili con lo strumento di svcutil.exe e genera un file di configurazione basato sulle proprietà di associazione selezionate quando ci si connette al database Oracle.
Generazione di una classe client tramite il plug-in Add Adapter Service Reference
Seguire questa procedura per generare una classe client WCF usando il plug-in Aggiungi riferimento al servizio adapter.
Per generare una classe client WCF
In Visual Studio Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto e quindi scegliere Aggiungi riferimento al servizio adapter.
Dopo aver aperto la finestra di dialogo Aggiungi riferimento al servizio adapter , seguire la procedura descritta in Recuperare i metadati per le operazioni Oracle in Visual Studio per connettersi al database Oracle e cercare le operazioni. Per creare una classe client WCF per le operazioni selezionate, assicurarsi che l'opzione Client (operazioni in uscita) sia selezionata nell'elenco a discesa Seleziona tipo di contratto (impostazione predefinita).
Dopo aver selezionato tutte le operazioni di destinazione, fare clic su OK per generare la classe client WCF.
Il plug-in Aggiungi riferimento al servizio adapter aggiunge due file al progetto:
OracleDBBindingClient.cs. Questo file contiene la classe client WCF generata e il codice helper per le operazioni selezionate.
App.config. Questo file contiene una configurazione di associazione e configurazioni dell'endpoint client. Queste configurazioni sono basate sulle selezioni effettuate quando è stata configurata l'associazione e la connessione per il plug-in di riferimento del servizio di aggiunta adapter.
Importante
Se si usa il plug-in Aggiungi riferimento al servizio adapter di Visual Studio, se non si specifica un valore per una proprietà di associazione di tipo string e il cui valore predefinito è Null, tale proprietà di associazione non sarà disponibile nel file di app.config. È necessario aggiungere manualmente la proprietà di associazione e il relativo valore nel file app.config, se necessario.
Generazione di un contratto di servizio WCF tramite il plug-in Add Adapter Service Reference
L'adapter espone le operazioni in ingresso per consentire al database Oracle di inviare messaggi a un client dell'adapter. Per tali operazioni è necessario generare un contratto di servizio WCF. Ad esempio, l'adapter espone un'operazione POLLINGSTMT in ingresso per eseguire il polling del database Oracle. L'adapter Oracle Database esegue la query specificata dalla proprietà di associazione PollingStatement e invia il set di risultati all'applicazione che utilizza in un messaggio POLLINGSTMT. In questo scenario, l'applicazione che usa funge da servizio e l'adapter Oracle Database funge da client. È quindi necessario implementare un servizio WCF in grado di ricevere l'operazione POLLINGSTMT dall'adapter. A tale scopo, usare il plug-in Aggiungi riferimento al servizio adapter per generare un'interfaccia .NET che rappresenta il contratto di servizio che viene visualizzato dall'adattatore per l'operazione POLLINGSTMT. Questa interfaccia .NET è detta anche contratto di servizio WCF. Questa interfaccia viene quindi implementata per creare il servizio WCF che è possibile usare per ricevere l'operazione POLLINGSTMT.
In questa sezione vengono fornite informazioni su come generare un contratto di servizio WCF usando il plug-in add adapter service reference per le operazioni in ingresso esposte dall'adapter.
Per generare un contratto di servizio WCF per le operazioni in ingresso
In Visual Studio Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto e quindi scegliere Aggiungi riferimento al servizio adapter.
Dopo aver aperto la finestra di dialogo Aggiungi riferimento al servizio adapter , seguire la procedura descritta in Recuperare i metadati per le operazioni Oracle in Visual Studio per connettersi al database Oracle. Sono disponibili diverse proprietà di associazione e una proprietà URI che è possibile impostare quando ci si connette al database Oracle per le operazioni in ingresso. Ad esempio, per l'operazione di polling in ingresso (POLLINGSTMT), è necessario specificare la proprietà di associazione PollingStatement quando si configura la connessione al database Oracle. L'adapter Oracle Database usa l'istruzione SQL SELECT specificata in questa proprietà per generare la classe che rappresenta il set di risultati restituito dall'operazione POLLINGSTMT.
Dopo aver eseguito la connessione al database Oracle, selezionare Servizio (operazioni in ingresso) nell'elenco a discesa Seleziona tipo di contratto .
Nella casella Seleziona una categoria fare clic sul nodo radice (/) e passare all'operazione per cui si desidera generare il contratto di servizio. Ad esempio, per l'operazione di polling, selezionare POLLINGSTMT nella casella Categorie e operazioni disponibili e quindi fare clic su Aggiungi.
Per generare il contratto di servizio WCF per l'operazione POLLINGSTMT, fare clic su OK.
Il plug-in Add Adapter Service Reference aggiunge tre file al progetto:
OracleDBBindingInterface.cs. Questo file contiene il contratto di servizio WCF generato (interfaccia) e il codice helper per l'operazione POLLINGSTMT.
OracleDBBindingService.cs. Questo file contiene una classe che implementa l'interfaccia definita in OracleDBBindingInterface.cs. È possibile implementare la logica di business che elabora i record restituiti dalla query di polling nel metodo POLLINGSTMT in questa classe.
App.config. Questo file contiene una configurazione dell'associazione, i comportamenti degli endpoint e la configurazione dell'endpoint di servizio basati sulle selezioni effettuate durante la configurazione dell'associazione e della connessione per il plug-in di riferimento del servizio adattatore.
Importante
Se si usa il plug-in Aggiungi riferimento al servizio adapter di Visual Studio, se non si specifica un valore per una proprietà di associazione di tipo string e il cui valore predefinito è Null, tale proprietà di associazione non sarà disponibile nel file di app.config. È necessario aggiungere manualmente la proprietà di associazione e il relativo valore nel file app.config, se necessario.
Utilizzo di svcutil.exe per generare una classe client WCF o un contratto di servizio WCF
È possibile usare svcutil.exe per generare una classe client WCF o un'interfaccia del servizio WCF per l'applicazione. È necessario configurare svcutil.exe per usarlo con l'adapter Oracle Database. Per altre informazioni sulla configurazione e sull'uso di svcutil.exe con l'adapter Oracle Database, vedere Uso dello strumento utilità metadati ServiceModel con l'adapter BizTalk per Oracle Database.
Svcutil.exe genera la classe client WCF o il contratto di servizio WCF in un file di output. Il nome file predefinito è output.cs. È necessario includere manualmente questo file nel progetto di Visual Studio.
Vedere anche
Sviluppare applicazioni di database Oracle usando il modello di servizio WCF
Esecuzione di operazioni di inserimento, aggiornamento, eliminazione e selezione di base in SQL tramite il modello di servizio WCF