Usare lo strumento WCF Web Service Reference Provider

Nel corso degli anni, molti sviluppatori di Visual Studio hanno aumentato la produttività usando lo strumento Aggiungi riferimento al servizio quando era necessario che i progetti .NET Framework accedessero ai servizi Web.

Lo strumento WCF Web Service Reference è un'estensione per servizio connesso di Visual Studio che consente di connettere il progetto .NET 5+, .NET Core o ASP.NET Core a un servizio Web. Offre un'esperienza simile alla funzionalità Aggiungi riferimento al servizio, disponibile solo per i progetti .NET Framework. Lo strumento WCF Web Service Reference consente di recuperare metadati da un servizio Web nella soluzione corrente, in un percorso di rete o da un file WSDL e genera un file di origine contenente il codice del proxy client Windows Communication Foundation (WCF) che l'app .NET può usare per accedere al servizio Web.

Importante

Si consiglia di fare riferimento solo a servizi provenienti da un'origine attendibile. L'aggiunta di riferimenti da un'origine non attendibile può compromettere la sicurezza.

Prerequisiti

• Visual Studio 2017 versione 15.5 o successiva

Gli screenshot di questo articolo provengono da Visual Studio 2022.

Come usare l'estensione

Nota

Lo strumento WCF Web Service Reference è applicabile solo ai progetti .NET Core e .NET Standard C#, incluse le app Web di ASP.NET Core.

Usando il modello di progetto Applicazione Web ASP.NET Core come esempio, questo articolo illustra i passaggi per aggiungere un riferimento al servizio WFC al progetto.

1. In Esplora soluzioni fare doppio clic sul nodo Servizi connessi del progetto. Per un progetto .NET Core o .NET Standard, fare clic con il pulsante destro del mouse sul progetto e scegliere Aggiungi> Servizio connesso.

   Verrà visualizzata la pagina Servizi connessi come illustrato nell'immagine seguente:

   

2. Nella pagina Servizi connessi selezionare Aggiungi riferimento al servizio.

   Verrà visualizzata la pagina Aggiungi riferimento al servizio.

3. Selezionare Servizio Web WCF e quindi scegliere Avanti.

   Verrà visualizzata la procedura guidata Aggiungi nuovo riferimento al servizio Servizio Web WCF.

   

4. Selezionare un servizio.

   a. Sono disponibili diverse opzioni di ricerca dei servizi:

   • Per cercare i servizi definiti nella soluzione corrente, fare clic sul pulsante Individua.
   • Per cercare i servizi ospitati all'indirizzo specificato, immettere un URL del servizio nella casella Indirizzo e fare clic sul pulsante Vai.
   • Per selezionare un file WSDL contenente le informazioni sui metadati del servizio Web, fare clic sul pulsante Sfoglia.

   b. Selezionare il servizio dall'elenco dei risultati della ricerca nella casella Servizi. Se necessario, immettere lo spazio dei nomi per il codice generato nella casella di testo Spazio dei nomi corrispondente.

   c. Fare clic sul pulsante Avanti per specificare le opzioni per i tipi di dati o le opzioni per i client. In alternativa, fare clic sul pulsante Fine per usare le opzioni predefinite.

5. La pagina Opzioni tipi di dati consente di ridefinire le impostazioni di configurazione del riferimento al servizio generato:

   

   Nota

   La casella di controllo Riutilizza tipi in assembly di riferimento è utile quando i tipi di dati necessari per la generazione del codice del riferimento al servizio sono definiti in uno degli assembly di riferimento del progetto. È importante riusare tali tipi di dati esistenti per evitare problemi di runtime o conflitto del tipo in fase di compilazione.

   È possibile che si verifichi un ritardo durante il caricamento delle informazioni, a seconda del numero di dipendenze del progetto e di altri fattori relativi alle prestazioni di sistema. Il pulsante Fine è disabilitato durante il caricamento, a meno che la casella di controllo Riutilizza tipi in assembly di riferimento non sia selezionata.

6. Fare clic su Fine al termine dell'operazione.

Durante la visualizzazione dello stato, lo strumento:

• Scarica i metadati dal servizio WCF.
• Genera il codice del riferimento al servizio in un file denominato reference.cse lo aggiunge al progetto sotto il nodo Servizi connessi.
• Aggiorna il file di progetto con estensione csproj con i riferimenti al pacchetto NuGet necessari per la compilazione e l'esecuzione nella piattaforma di destinazione.

Al termine di questi processi, è possibile creare un'istanza del tipo di client WCF generato e richiamare le operazioni del servizio.

Vedi anche

• Introduzione alle applicazioni Windows Communication Foundation
• Servizi Windows Communication Foundation e dati WCF in Visual Studio
• Funzionalità supportate da WCF in .NET Core

Commenti, suggerimenti e domande

Se si hanno commenti e suggerimenti sul prodotto, inviarli nella Developer Community usando lo strumento Segnala un problema.

Note sulla versione

• Fare riferimento alle note sulla versione per informazioni aggiornate sulle versioni, compresi i problemi noti.