Procedura: aggiungere e rimuovere riferimenti Web

Articolo
10/22/2014

Aggiornamento: novembre 2007

Un riferimento Web consente di utilizzare in un progetto uno o più servizi Web XML. Utilizzare Finestra di dialogo Aggiungi riferimento Web per ricercare i servizi Web localmente, in una rete LAN o su Internet.

Dopo aver aggiunto un riferimento Web al progetto corrente, è possibile chiamare qualsiasi metodo esposto dal servizio Web. Per informazioni, vedere Procedura: chiamare un servizio Web.

Per informazioni sulla creazione di una classe di servizi Web, vedere Procedura dettagliata: Creazione di un servizio Web XML di base tramite ASP.NET.

Per aggiungere un riferimento Web a un progetto

In Esplora soluzioni fare clic con il pulsante destro del mouse sul nome del progetto in cui aggiungere il servizio Web, quindi scegliere 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" in Visual Studio 2005 SDK.

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" in Visual Studio 2005 SDK.

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 nel computer locale. Per ulteriori informazioni, vedere°Cenni preliminari sui pericoli di protezione a cui sono esposte le applicazioni Web e 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 nel computer locale. Per ulteriori informazioni, vedere°Cenni preliminari sui pericoli di protezione a cui sono esposte le applicazioni Web e 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 riferimento Web viene creato da Visual Web Developer compilando 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), nei quali sono incluse 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 riferimento Web viene creato da Visual Web Developer compilando 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), nei quali sono incluse informazioni sulla posizione del servizio Web.

Scegliere Aggiungi riferimento.

Se il sito Web non ne contiene già una, Visual Studio crea una cartella App_WebReferences, nonché i file richiesti per la classe proxy utilizzando il nome fornito nel passaggio 5.

Rimozione di un riferimento Web

Se per il progetto non è più necessario un riferimento Web a un servizio Web XML, è possibile rimuoverlo dal progetto.

Per rimuovere un riferimento Web da un progetto

In Esplora soluzioni fare clic con il pulsante destro del mouse sul riferimento Web, quindi scegliere Elimina.

Tutte le informazioni relative al riferimento verranno rimosse dal progetto e dall'archivio locale.

Vedere anche

Attività

Procedura: chiamare un servizio Web

Procedura dettagliata: creazione e utilizzo di un servizio Web ASP.NET in Visual Web Developer

Procedura dettagliata: Creazione di un servizio Web XML di base tramite ASP.NET

Concetti

Panoramica dei servizi Web XML

Condividi tramite