Generare un client WCF o un contratto di servizio WCF per elementi SQL Server
È possibile usare il plug-in Add Adapter Service Reference Visual Studio per generare una classe client WCF destinata alle operazioni selezionate in SQL Server artefatti. È anche possibile usare serviceModel Metadata Utility Tool (svcutil.exe) per generare la classe client WCF; Tuttavia, il plug-in Add Adapter Service Reference espone la funzionalità dello strumento utilità metadati ServiceModel tramite un'interfaccia Microsoft Windows standard. Fornisce anche funzionalità di ricerca e sfoglia che non sono disponibili con lo strumento di svcutil.exe e genera un file di configurazione in base alle proprietà di associazione selezionate quando ci si connette al database di SQL Server.
Generazione di una classe client WCF usando il plug-in Add Adapter Service Reference
Seguire questa procedura per generare una classe client WCF usando il plug-in Add Adapter Service Reference.
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 Recupera metadati per le operazioni di SQL Server in Visual Studio usando l'adattatore SQL per connettersi a SQL Server e cercare le operazioni. Per creare una classe client WCF per le operazioni selezionate, assicurarsi che il client (operazioni in uscita) sia selezionato dall'elenco a discesa Seleziona tipo di contratto . (Si tratta dell'impostazione predefinita).
Dopo aver selezionato tutte le operazioni di destinazione, fare clic su OK per generare la classe client WCF.
Il plug-in Add Adapter Service Reference aggiunge due file al progetto:
File di codice client WCF. Questo file contiene la classe client WCF generata e il codice helper per le operazioni selezionate. La prima volta che si esegue il plug-in Add Adapter Service Reference Visual Studio, questo file verrà generato con il nome predefinito SQLAdapterBindingClient.cs. Se viene eseguito di nuovo, il file successivo generato verrà chiamato SQLAdapterBindingClient1.cs. Il suffisso numero aumenterà di 1 per ogni nuovo file generato. È anche possibile modificare il prefisso predefinito SQLBinding immettendo un prefisso diverso nel campo Prefisso Nome file del plug-in Aggiungi plug-in del servizio adapter di Visual Studio prima di selezionare OK per generare il file.
App.config. Questo file contiene una configurazione di associazione e configurazioni dell'endpoint client basate sulle selezioni effettuate quando è stata configurata la connessione per il plug-in Add Adapter Service Reference.
Importante
Quando si usa il plug-in Add Adapter Service Reference, se non si specifica un valore per una proprietà di tipo stringa di tipo e il cui valore predefinito è Null, tale proprietà di associazione non sarà disponibile nel file app.config. È necessario aggiungere manualmente la proprietà di associazione e il relativo valore nel file di app.config, se necessario.
Generazione di un contratto di servizio WCF usando il plug-in Add Adapter Service Reference
Per le operazioni in ingresso, ad esempio il polling del database SQL Server o la ricezione di notifiche dal database, l'adapter SQL esegue una query specificata dall'applicazione client (nel caso del polling) o registra una query con SQL Server (in caso di notifica). In entrambi gli scenari, l'adapter invia il messaggio in ingresso da SQL Server database all'utilizzo. In tal caso, l'applicazione che usa funge da servizio e l'adapter SQL funge da client. È quindi necessario implementare un servizio WCF che può ricevere operazioni in ingresso dall'adapter. A tale scopo, usare il plug-in Add Adapter Service Reference per generare un'interfaccia .NET che rappresenta il contratto di servizio che viene visualizzato dall'adattatore per le operazioni in ingresso. Questa interfaccia .NET viene anche chiamata contratto di servizio WCF. È quindi possibile implementare questa interfaccia per creare il servizio WCF che è possibile usare per ricevere le operazioni in ingresso.
Seguire questa procedura per generare un contratto di servizio WCF usando il plug-in Aggiungi plug-in del servizio 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 Connetti a SQL Server in Visual Studio usando il plug-in Aggiungi plug-in di riferimento del servizio adapter per connettersi al database SQL Server.
Importante
Se si genera un contratto di servizio WCF per l'operazione in ingresso TypedPolling , è necessario specificare InboundID come parte della proprietà di associazione URI di connessione e PollingStatement .
Dopo aver eseguito la connessione al database SQL Server, selezionare Servizio (operazioni in ingresso) nell'elenco a discesa Seleziona tipo di contratto.
Nella casella Seleziona una categoria fare clic sul nodo radice (/), selezionare l'operazione in ingresso nella casella Categorie e operazioni disponibili e quindi fare clic su Aggiungi.
Per generare il contratto di servizio WCF per l'operazione in ingresso, fare clic su OK.
Il plug-in Add Adapter Service Reference aggiunge tre file al progetto:
SqlAdapterBindingInterface.cs. Questo file contiene il codice del contratto di servizio WCF generato (interfaccia) e il codice helper per l'operazione in ingresso.
SqlAdapterBindingService.cs. Questo file contiene una classe che implementa l'interfaccia definita in SqlAdapterBindingInterface.cs. È possibile implementare la logica di business che elabora i record restituiti dall'operazione in ingresso.
app.config. Questo file contiene una configurazione di associazione, comportamenti dell'endpoint e configurazione dell'endpoint di servizio in base alle selezioni effettuate quando è stata configurata l'associazione e la connessione per il plug-in Add Adapter Service Reference Plug-in.
Importante
Quando si usa il plug-in Add Adapter Service Reference, se non si specifica un valore per una proprietà di tipo stringa di tipo e il cui valore predefinito è Null, tale proprietà di associazione non sarà disponibile nel file app.config. È necessario aggiungere manualmente la proprietà di associazione e il relativo valore nel file di app.config, se necessario.
Generazione di una classe client WCF usando svcutil.exe
È possibile usare svcutil.exe per generare una classe client WCF per l'applicazione. È necessario configurare svcutil.exe per usarlo con l'adapter SQL.
Svcutil.exe genera la classe client WCF in un file di output con un nome di file predefinito di output.cs. È necessario includere manualmente questo file nel progetto di Visual Studio. Per altre informazioni sulle svcutil.exe, vedere Strumento utilità metadati ServiceModel (Svcutil.exe).
Vedere anche
Sviluppare applicazioni SQL usando il modello di servizio WCF