Procedura: aggiungere un riferimento a un servizio Web

I Servizi Web XML, anche noti come servizi di ASMX, sono i predecessori di Windows Communication Foundation (WCF). È possibile accedere ai servizi Web aggiungendo un riferimento al servizio come avviene per qualsiasi altro servizio WCF. Tutti i riferimenti aggiunti in questo modo saranno destinati all'ultima versione di .NET Framework.

Per le applicazioni create in una versione precedente di Visual Studio, è ancora possibile aggiungere un riferimento Web che indirizza alla versione 2.0 di .NET Framework. A questo scopo, seguire la procedura descritta nella sezione seguente.

Nota

È necessario aggiungere un riferimento Web solo se l'applicazione indirizza alla versione 2.0 di .NET Framework.Per aggiungere un riferimento al servizio che indirizza alla versione corrente di .NET Framework, vedere Procedura: aggiungere, aggiornare o rimuovere un riferimento al servizio.

Per aggiungere un riferimento Web a un progetto

1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul nome del progetto a cui si desidera aggiungere il servizio, quindi scegliere Aggiungi riferimento a servizio.

   Verrà visualizzata la finestra di dialogo Aggiungi riferimento a servizio.

2. Nella finestra di dialogo Aggiungi riferimento a servizio fare clic sul pulsante Avanzate.

   Verrà visualizzata la finestra di dialogo Impostazioni riferimento al servizio.

3. Nella finestra di dialogo Impostazioni riferimento al servizio fare clic su Aggiungi riferimento Web.

   Verrà visualizzata la finestra di dialogo Aggiungi riferimento Web.

4. Nella casella URL immettere l'URL del servizio Web da utilizzare. Se non si conosce l'URL, utilizzare i collegamenti nel riquadro del browser per individuare il servizio Web desiderato.

   Nota

   Se un'applicazione Web viene sviluppata in un computer protetto da un firewall e se tale applicazione dovrà utilizzare servizi Web che si trovano all'esterno del firewall, l'URL dovrà includere l'indirizzo e la porta del server proxy di rete.Questa parte del percorso dell'URL viene in genere fornita dall'amministratore di rete.Per ulteriori informazioni, vedere Le impostazioni proxy del computer non sono configurate correttamente per l'individuazione Web..

5. Nella casella Servizi Web disponibili a questo URL selezionare il servizio Web da utilizzare.

6. Verificare che il progetto sia in grado di utilizzare il servizio Web e che ogni codice esterno fornito sia affidabile.

   Nota sulla sicurezza

   Quando si apre per la modifica un progetto che include un riferimento Web, un file proxy locale per il servizio Web utilizzato viene eseguito in un processo di Devenv.exe avviato da un utente considerato attendibile.L'apertura di progetti o componenti nell'ambiente di sviluppo integrato (IDE, Integrated Development Environment) rende possibile l'esecuzione di codice sul computer locale.Per ulteriori informazioni, vedere Code Access Security.

7. Nel campo Nome riferimento Web immettere il nome che verrà utilizzato nel codice per accedere a livello di codice al servizio Web selezionato.

   Nota

   Per impostazione predefinita, ai riferimenti Web è assegnato uno spazio dei nomi che corrisponde al nome del server.È possibile modificare tale valore e immettere un nome dello spazio dei nomi personalizzato.Esistono alcune limitazioni sui nomi accettabili.Per ulteriori informazioni su caratteri non consentiti in un nome riferimento Web, vedere Finestra di dialogo Aggiungi riferimento Web.Lo spazio dei nomi basato sul nome del riferimento Web viene creato mediante la compilazione di una gerarchia di cartelle annidate.Nella cartella più interna viene creato un file wsdl che fa riferimento al servizio Web, insieme ai file di supporto, quali i file di individuazione (disco e discomap), che contengono informazioni sulla posizione del servizio Web.

8. Scegliere Aggiungi riferimento.

   Se il sito del progetto non dispone già di un riferimento, in Visual Studio viene creata una cartella WebReferences. Vengono quindi creati i file necessari per la classe proxy utilizzando il nome specificato nel passaggio 7.

Vedere anche

Attività

Procedura: aggiungere, aggiornare o rimuovere un riferimento al servizio

Riferimenti

Finestra di dialogo Aggiungi riferimento al servizio

Concetti

Servizi Windows Communication Foundation e dati WCF in Visual Studio

Altre risorse

Consuming ASMX and WCF Services Sample

Web References in Visual Studio