Aggiungere, aggiornare o rimuovere un riferimento al servizio dati WCF

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).

Annotazioni

Il computer potrebbe visualizzare nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio in questo articolo. È 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. Consulta per modificare Visual Studio.

Aggiungere un riferimento al servizio WCF

Per aggiungere un riferimento a un servizio esterno (progetti .NET Framework)

1. 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 .

2. 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 Scopri e quindi scegliere Servizi nella Soluzione.

   Annotazioni

   È consigliabile fare riferimento solo ai servizi 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.

3. Nell'elenco Servizi espandere il nodo per il servizio che si vuole usare e selezionare un set di entità.

4. Nella casella Spazio dei nomi immettere lo spazio dei nomi che si desidera usare per il riferimento.

5. 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)

1. In Esplora soluzioni fare doppio clic o toccare il nodo Servizi connessi .

   Verrà visualizzata la scheda Configura servizi .

2. Scegliere Microsoft WCF Web Service Reference Provider.

   Viene visualizzata la finestra di dialogo Configura riferimento al servizio Web WCF .

   

3. 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.

   Annotazioni

   È consigliabile fare riferimento solo ai servizi 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.

4. Nell'elenco Servizi espandere il nodo per il servizio che si vuole usare e selezionare un set di entità.

5. Nella casella Spazio dei nomi immettere lo spazio dei nomi che si desidera usare per il riferimento.

6. 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)

1. 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 .

2. Fare clic su Scopri.

   Tutti i servizi (sia WCF Data Services che i servizi WCF) nella soluzione corrente vengono aggiunti all'elenco Servizi .

3. Nell'elenco Servizi espandere il nodo per il servizio che si vuole usare e selezionare un set di entità.

4. Nella casella Spazio dei nomi immettere lo spazio dei nomi che si desidera usare per il riferimento.

5. 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)

1. In Esplora soluzioni fare doppio clic o toccare il nodo Servizi connessi .

   Verrà visualizzata la scheda Configura servizi .

2. Scegliere Microsoft WCF Web Service Reference Provider.

   Viene visualizzata la finestra di dialogo Configura riferimento al servizio Web WCF .

3. Fare clic su Scopri.

   Tutti i servizi (sia WCF Data Services che i servizi WCF) nella soluzione corrente vengono aggiunti all'elenco Servizi .

4. Nell'elenco Servizi espandere il nodo per il servizio che si vuole usare e selezionare un set di entità.

5. Nella casella Spazio dei nomi immettere lo spazio dei nomi che si desidera usare per il riferimento.

6. 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

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 .

  Annotazioni

  Qualsiasi codice che fa riferimento al riferimento al servizio deve essere rimosso manualmente.

Contenuti correlati

• Servizi di Windows Communication Foundation e servizi dati WCF in Visual Studio