Creazione del proxy del servizio Web

  • Articolo

Un client e un servizio Web possono comunicare utilizzando messaggi SOAP, che incapsulano i parametri di input e di output in formato XML. Una classe proxy esegue il mapping dei parametri agli elementi XML, quindi invia i messaggi SOAP in una rete. In questo modo, la classe proxy elimina l'esigenza di comunicare con il servizio Web a livello SOAP e consente di richiamare i metodi del servizio Web in qualsiasi ambiente di sviluppo che supporti i proxy del servizio Web e SOAP.

È possibile aggiungere una classe proxy al progetto di sviluppo usando Microsoft .NET Framework in due modi: con lo strumento WSDL in .NET Framework o aggiungendo un riferimento Web in Microsoft Visual Studio. Nelle sezioni seguenti questo argomento viene illustrato in modo più dettagliato.

Aggiunta del proxy utilizzando lo strumento WSDL

.NET Framework SDK include lo strumento WSDL (Web Services Description Language) (Wsdl.exe), che consente di generare un proxy del servizio Web da usare nell'ambiente di sviluppo di .NET Framework. Il modo più comune per creare un proxy client nei linguaggi che supportano i servizi Web (attualmente C# e Microsoft Visual Basic ) è usare lo strumento WSDL.

Per aggiungere una classe proxy al progetto usando Wsdl.exe

  1. Dal prompt dei comandi utilizzare Wsdl.exe per creare una classe proxy, specificando almeno l'URL del servizio Web ReportServer.

    Nell'istruzione del prompt dei comandi seguente viene ad esempio specificato un URL per l'endpoint di gestione del servizio Web ReportServer:

    wsdl /language:CS /n:"Microsoft.SqlServer.ReportingServices2010" https://<Server Name>/reportserver/reportservice2010.asmx?wsdl

    Lo strumento WSDL accetta diversi argomenti del prompt dei comandi per la generazione di un proxy. Nell'esempio precedente sono specificati il linguaggio C# e uno spazio dei nomi suggerito da utilizzare nel proxy (per impedire il conflitto tra i nomi in caso di utilizzo di più di un endpoint servizio Web) e viene generato un file C# denominato ReportingService2010.cs. Se nell'esempio fosse stato specificato Visual Basic, sarebbe stato generato un file proxy denominato ReportingService2010.vb. Questo file viene creato nella directory dalla quale si esegue il comando.

  2. Compilare la classe proxy in un file di assembly (con estensione dll) e farvi riferimento nel progetto oppure aggiungere la classe come elemento del progetto.

    Nota

    Quando si aggiunge manualmente una classe proxy al progetto, è necessario aggiungere un riferimento a System.Web.Services.dll. Se si aggiunge il proxy utilizzando un riferimento Web in Visual Studio .NET, il riferimento viene creato automaticamente. Per ulteriori informazioni, vedere "Aggiunta del proxy utilizzando un riferimento Web in Visual Studio" più avanti in questo argomento.

    Dopo avere aggiunto la classe proxy come elemento nel progetto, il file associato viene visualizzato in Esplora soluzioni.

  3. Per chiamare il servizio a livello di programmazione, creare un'istanza della classe proxy.

    Nell'esempio di codice seguente viene illustrata la sintassi per la creazione di un'istanza della classe proxy ReportingService2010 in un progetto.

Dim service As New ReportingService2010()  

ReportingService2010 service = new ReportingService2010();

Per altre informazioni sullo strumento Wsdl.exe, inclusa la sintassi completa, vedere "Strumento del linguaggio di descrizione dei servizi Web (Wsdl.exe)" nella documentazione di .NET Framework SDK. Per una spiegazione completa relativa ai proxy del servizio Web, vedere "Creazione di un proxy del servizio Web XML" nella documentazione di .NET Framework SDK.

Aggiunta del proxy utilizzando un riferimento Web in Visual Studio

Un riferimento Web consente l'utilizzo di uno o più servizi Web in un progetto. Visual Studio consente agli utenti di aggiungere ai progetti riferimenti al servizio Web tramite alcuni semplici passaggi.

Per aggiungere un riferimento Web a un progetto

  1. In Esplora soluzioni selezionare il progetto in cui verrà usato il servizio Web.

  2. Nel menu Progetto fare clic su Aggiungi riferimento Web.

    Viene visualizzata la finestra di dialogo Aggiungi riferimento Web.

  3. Nel campo URL immettere il percorso completo del servizio Web ReportServer.

    Un URL semplificato per l'endpoint di esecuzione del report del servizio Web ReportServer potrebbe essere simile al seguente:

    https://<Server Name>/reportserver/reportexecution2005.asmx

    L'URL contiene il dominio nel quale viene distribuito il servizio Web ReportServer, il nome della cartella contenente il servizio e il nome del file di individuazione per il servizio. Per una descrizione completa dei diversi elementi dell'URL, vedere Accesso all'API SOAP.

    Una descrizione delle proprietà e dei metodi forniti dal servizio Web viene visualizzata nel riquadro del visualizzatore a sinistra.

    Nota

    Per altre informazioni sugli elementi associati al servizio Web ReportServer, vedere Metodi del servizio Web ReportServer.

  4. Verificare che il progetto possa utilizzare il servizio Web ReportServer, nonché di disporre delle autorizzazioni appropriate per l'accesso al server di report.

  5. Nel campo Nome riferimento Web immettere il nome che verrà usato nel codice per accedere a livello di programmazione al servizio Web ReportServer.

  6. Fare clic sul pulsante Aggiungi riferimento per creare un riferimento al servizio Web nell'applicazione.

    Il nuovo riferimento verrà visualizzato in Esplora soluzioni nel nodo Riferimenti Web per il progetto attivo e con il nome specificato nel campo Nome riferimento Web.

  7. In Esplora soluzioni espandere la cartella Riferimenti Web per visualizzare lo spazio dei nomi per le classi del riferimento Web disponibili per gli elementi del progetto.

    Dopo l'aggiunta di un riferimento Web al progetto, i file associati vengono visualizzati in una sottocartella della cartella Riferimenti Web di Esplora soluzioni.

Dopo avere aggiunto il riferimento Web, utilizzare la sintassi seguente per creare un'istanza della classe proxy:

Dim rs As New myNamespace.myReferenceName.ReportExecutionService()  
rs.Url = "https://<Server Name>/reportserver/reportexecution2005.asmx?wsdl"  
rs.Credentials = System.Net.CredentialCache.DefaultCredentials  

myNamespace.myReferenceName.ReportExecutionService rs = new myNamespace.myReferenceName.ReportExecutionService();  
rs.Url = "https://<Server Name>/reportserver/reportexecution2005.asmx?wsdl";  
rs.Credentials = System.Net.CredentialCache.DefaultCredentials;

È anche possibile aggiungere una direttiva using (Import in Visual Basic) al riferimento al servizio Web ReportServer. Quando si utilizza questa direttiva, non è necessario specificare il nome completo dei tipi nello spazio dei nomi. A tale scopo, aggiungere al file il codice seguente:

Import myNamespace.myReferenceName  

using myNamespace.myReferenceName;

Vedere anche

Servizio Web ReportServer
Compilazione di applicazioni tramite servizio Web e .NET Framework
Guida di riferimento tecnico (SSRS)