Procedura: aggiungere un riferimento a un servizio Web

Articolo
09/12/2008

Aggiornamento: novembre 2007

I Servizi Web XML, anche noti come servizi di ASMX, sono i predecessori di Windows Communication Foundation (WCF). È possibile accedere ai servizi Web aggiungendovi un riferimento come per qualsiasi altro servizio WCF. Tutti i riferimenti aggiunti in questo modo sono destinati alla versione più recente 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

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.
Nella finestra di dialogo Aggiungi riferimento a servizio fare clic sul pulsante Avanzate.

Verrà visualizzata la finestra di dialogo Impostazioni riferimento al servizio.
Nella finestra di dialogo Impostazioni riferimento al servizio fare clic su Aggiungi riferimento Web.

Verrà visualizzata la finestra di dialogo Aggiungi riferimento Web.

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.

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.

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

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 Protezione dall'accesso di codice.

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 Protezione dall'accesso di codice.

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

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

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

Condividi tramite

Procedura: aggiungere un riferimento a un servizio Web

Per aggiungere un riferimento Web a un progetto

Vedere anche

Attività

Concetti

Riferimenti

Altre risorse

Risorse aggiuntive