Usare lo strumento di riferimento per il servizio Web WCF

Nel corso degli anni, molti sviluppatori di Visual Studio hanno apprezzato l'efficienza fornita dallo strumento Aggiungi riferimento al servizio quando i loro progetti .NET Framework necessitavano di accedere ai servizi Web.

Lo strumento di riferimento al servizio Web WCF è un'estensione del 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 , che è solo per i progetti .NET Framework. Lo strumento wcf Web Service Reference recupera i 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 proxy client windows Communication Foundation (WCF) che l'app .NET può usare per accedere al servizio Web.

Importante

È consigliabile fare riferimento solo ai servizi da un'origine attendibile. L'aggiunta di riferimenti da un'origine non attendibile può compromettere la sicurezza.

Prerequisiti

• Visual Studio 2017 o versione successiva

Gli screenshot di questo articolo provengono da Visual Studio 2022.

Come usare l'estensione

Annotazioni

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

Usando il modello di progetto ASP.NET Core Web Application come esempio, questo articolo illustra come aggiungere un riferimento al servizio WCF 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.

   La pagina Servizi connessi viene visualizzata 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 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 Discover.
   • Per cercare i servizi ospitati in un 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 corrispondente Namespace.

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

5. La pagina delle opzioni del tipo di dati consente di perfezionare le impostazioni di configurazione dei riferimenti al servizio generate:

   

   Annotazioni

   L'opzione di controllo Riutilizza tipi negli assembly a cui si fa riferimento è utile quando i tipi di dati necessari per la generazione del codice di riferimento del servizio sono definiti in uno degli assembly di riferimento del progetto. È importante riutilizzare questi tipi di dati esistenti per evitare conflitti di tipi in fase di compilazione o problemi di runtime.

   Potrebbe verificarsi un ritardo durante il caricamento delle informazioni sul tipo, a seconda del numero di dipendenze del progetto e di altri fattori di prestazioni del sistema. Il pulsante Fine è disabilitato durante il caricamento, a meno che la casella di controllo Riutilizza tipi negli assembly a cui si fa riferimento non sia deselezionata.

6. Al termine, fare clic su Fine .

Durante la visualizzazione dello stato di avanzamento, lo strumento:

• Scarica i metadati dal servizio WCF.
• Genera il codice di riferimento del servizio in un file denominato reference.cs e lo aggiunge al progetto nel nodo Servizi connessi .
• Aggiorna il file di progetto (con estensione csproj) con i riferimenti al pacchetto NuGet necessari per compilare ed eseguire 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.

Vedere anche

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

Feedback e domande

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

Note di rilascio

• Per informazioni sulla versione aggiornate, inclusi i problemi noti, vedere le note sulla versione.