Aggiungere, aggiornare o rimuovere un riferimento a WCF Data Services
Per i progetti .NET Framework, il riferimento al servizio consente a un progetto di accedere a uno o più WCF Data Services. Utilizzare la finestra di dialogo Aggiungi riferimento al servizio per cercare WCF Data Services nella soluzione corrente, in locale, in una rete locale o in Internet.
Per i progetti .NET Core, è possibile usare il nodo Servizi connessi in Esplora soluzioni per accedere al provider di riferimento del servizio Web WCF Microsoft, che consente di gestire i riferimenti al servizio dati Windows Communication Foundation (WCF).
Nota
I nomi o i percorsi visualizzati per alcuni elementi dell'interfaccia utente di Visual Studio in questo articolo potrebbero essere diversi nel computer in uso. È possibile usare un'edizione diversa di Visual Studio o impostazioni di ambiente diverse. Per altre informazioni, vedere Personalizzare l'IDE.
Prerequisiti
Gli strumenti WCF non vengono installati con il carico di lavoro .NET; usare il Programma di installazione di Visual Studio per modificare l'installazione. Nel programma di installazione scegliere Windows Communication Foundation in Singoli componenti. Vedere Modificare Visual Studio.
Aggiungere un riferimento al servizio WCF
Per aggiungere un riferimento a un servizio esterno (progetti .NET Framework)
In Esplora soluzioni fare clic con il pulsante destro del mouse sul nome del progetto a cui si vuole aggiungere il servizio e quindi scegliere Aggiungi riferimento al servizio.
Verrà visualizzata la finestra di dialogo Aggiungi riferimento al servizio.
Nella casella Indirizzo immettere l'URL per il servizio e quindi selezionare Vai per cercare il servizio. Se il servizio implementa il nome utente e la sicurezza della password, potrebbe essere richiesto un nome utente e una password. È anche possibile scegliere un servizio nella propria soluzione. Scegliere il pulsante Individua e quindi scegliere Servizi in Soluzione.
Nota
Si consiglia di fare riferimento solo a servizi provenienti da un'origine attendibile. L'aggiunta di riferimenti da un'origine non attendibile potrebbe compromettere la sicurezza.
È anche possibile selezionare l'URL dall'elenco indirizzi , in cui sono archiviati i 15 URL precedenti in cui sono stati trovati metadati validi del servizio.
Quando viene eseguita la ricerca, viene visualizzata una barra di stato. È possibile arrestare la ricerca in qualsiasi momento facendo clic su Arresta.
Nell'elenco Servizi espandere il nodo per il servizio che si vuole usare e selezionare un set di entità.
Nella casella Spazio dei nomi immettere lo spazio dei nomi che si desidera usare per il riferimento.
Fare clic su OK per aggiungere il riferimento al progetto.
Viene generato un client del servizio (proxy) e i metadati che descrivono il servizio vengono aggiunti al file app.config .
Per aggiungere un riferimento a un servizio esterno (progetti .NET Core, inclusi .NET 5 e versioni successive)
In Esplora soluzioni fare doppio clic o toccare il nodo Servizi connessi.
Verrà visualizzata la scheda Configura servizi .
Scegliere Microsoft WCF Web Service Reference Provider .Choose Microsoft WCF Web Service Reference Provider.Choose Microsoft WCF Web Service Reference Provider.
Viene visualizzata la finestra di dialogo Configura riferimento al servizio Web WCF.
Nella casella URI immettere l'URL per il servizio e quindi selezionare Vai per cercare il servizio. Se il servizio implementa il nome utente e la sicurezza della password, potrebbe essere richiesto un nome utente e una password.
Nota
Si consiglia di fare riferimento solo a servizi provenienti da un'origine attendibile. L'aggiunta di riferimenti da un'origine non attendibile potrebbe compromettere la sicurezza.
È anche possibile selezionare l'URL dall'elenco URI , che archivia i 15 URL precedenti in cui sono stati trovati i metadati del servizio validi.
Quando viene eseguita la ricerca, viene visualizzata una barra di stato. È possibile arrestare la ricerca in qualsiasi momento facendo clic su Arresta.
Nell'elenco Servizi espandere il nodo per il servizio che si vuole usare e selezionare un set di entità.
Nella casella Spazio dei nomi immettere lo spazio dei nomi che si desidera usare per il riferimento.
Fare clic su Fine per aggiungere il riferimento al progetto.
Viene generato un client del servizio (proxy) e i metadati che descrivono il servizio vengono aggiunti al file app.config .
Per aggiungere un riferimento a un servizio nella soluzione corrente (progetti .NET Framework)
In Esplora soluzioni fare clic con il pulsante destro del mouse sul nome del progetto a cui si vuole aggiungere il servizio e quindi scegliere Aggiungi riferimento al servizio.
Verrà visualizzata la finestra di dialogo Aggiungi riferimento al servizio.
Fare clic su Individua.
Tutti i servizi (sia WCF Data Services che i servizi WCF) nella soluzione corrente vengono aggiunti all'elenco Servizi .
Nell'elenco Servizi espandere il nodo per il servizio che si vuole usare e selezionare un set di entità.
Nella casella Spazio dei nomi immettere lo spazio dei nomi che si desidera usare per il riferimento.
Fare clic su OK per aggiungere il riferimento al progetto.
Un client del servizio (proxy) genera e i metadati che descrivono il servizio vengono aggiunti al file app.config .
Per aggiungere un riferimento a un servizio nella soluzione corrente (progetti.NET Core)
In Esplora soluzioni fare doppio clic o toccare il nodo Servizi connessi.
Verrà visualizzata la scheda Configura servizi .
Scegliere Microsoft WCF Web Service Reference Provider .Choose Microsoft WCF Web Service Reference Provider.Choose Microsoft WCF Web Service Reference Provider.
Viene visualizzata la finestra di dialogo Configura riferimento al servizio Web WCF.
Fare clic su Individua.
Tutti i servizi (sia WCF Data Services che i servizi WCF) nella soluzione corrente vengono aggiunti all'elenco Servizi .
Nell'elenco Servizi espandere il nodo per il servizio che si vuole usare e selezionare un set di entità.
Nella casella Spazio dei nomi immettere lo spazio dei nomi che si desidera usare per il riferimento.
Fare clic su Fine per aggiungere il riferimento al progetto.
Un client del servizio (proxy) genera e i metadati che descrivono il servizio vengono aggiunti al file app.config .
Aggiornare un riferimento al servizio
Il modello di dati di entità per WCF Data Services talvolta cambia. In questo caso, è necessario aggiornare il riferimento al servizio.
Per aggiornare un riferimento al servizio
In Esplora soluzioni fare clic con il pulsante destro del mouse sul riferimento al servizio e quindi scegliere Aggiorna riferimento al servizio.
Viene visualizzata una finestra di dialogo di stato mentre il riferimento viene aggiornato dalla posizione originale e il client del servizio viene rigenerato per riflettere eventuali modifiche nei metadati.
Per i progetti .NET Core, usare lo dotnet-svcutil strumento . Per istruzioni e installazione, vedere dotnet-svcutil .
Per i progetti .NET Framework:
In Esplora soluzioni espandere il nodo Servizi connessi, fare clic con il pulsante destro del mouse sul riferimento al servizio e quindi scegliere Aggiorna riferimento al servizio.
Viene visualizzata una finestra di dialogo di stato mentre il riferimento viene aggiornato dalla posizione originale e il client del servizio viene rigenerato per riflettere eventuali modifiche nei metadati.
Rimuovere un riferimento al servizio
Se non viene più usato un riferimento al servizio, è possibile rimuoverlo dalla soluzione.
Per rimuovere un riferimento al servizio
In Esplora soluzioni fare clic con il pulsante destro del mouse sul riferimento al servizio e quindi scegliere Elimina.
Il client del servizio verrà rimosso dalla soluzione e i metadati che descrivono il servizio verranno rimossi dal file app.config .
Nota
Qualsiasi codice che fa riferimento al riferimento al servizio deve essere rimosso manualmente.