Riferimenti Web in Visual Studio

Articolo
10/22/2014

Aggiornamento: novembre 2007

Per semplificare lo sviluppo di applicazioni client di servizi Web XML, in Visual Studio vengono forniti riferimenti Web. I riferimenti Web differiscono dai tradizionali riferimenti e componenti. Anziché fare riferimento a un componente o a una libreria di classi installata nel computer locale, un riferimento Web fornisce l'accesso a una risorsa disponibile mediante un protocollo Internet quale SOAP o HTTP.

In pratica un riferimento Web è costituito da una classe proxy generata che rappresenta le funzionalità esposte di un servizio Web XML su un computer locale. La classe proxy definisce i metodi effettivi esposti da un servizio Web XML. Quando nell'applicazione client viene creata un'istanza della classe proxy, è possibile chiamare i metodi del servizio Web XML come se questo fosse un componente disponibile sul computer locale. Per informazioni sulla creazione di un riferimento Web, vedere Procedura: aggiungere e rimuovere riferimenti Web.

Nota:
Se si desidera che i servizi Web XML esterni a un firewall siano disponibili nel browser Web, quando si crea il riferimento Web in Visual Studio è necessario specificare in modo esplicito l'indirizzo e la porta del server proxy della rete.

Il linguaggio di programmazione di una classe proxy generata sarà identico a quello del servizio Web rappresentato dalla classe proxy. Se la classe proxy viene creata in modo indipendente da Visual Studio, ad esempio utilizzando uno strumento di .NET Framework, il linguaggio di programmazione dipenderà dallo strumento utilizzato. Se ad esempio si utilizza WSDL.exe, il linguaggio di programmazione deve essere specificato nella riga di comando e può essere C# o Visual Basic, mentre se si utilizza SProxy.exe il linguaggio di programmazione è Visual C++. Per ulteriori informazioni, vedere Strumento del linguaggio di descrizione dei servizi Web (Wsdl.exe).

In fase di progettazione, la classe proxy consente di utilizzare il completamento delle istruzioni per i metodi del servizio Web XML. In fase di esecuzione, una chiamata a un metodo dell'oggetto proxy viene elaborata e codificata come messaggio di richiesta SOAP. Se il servizio Web XML non supporta SOAP, verranno utilizzati HTTP GET e HTTP POST. Il messaggio viene quindi inviato al servizio Web di destinazione per l'elaborazione. Se nella descrizione del servizio è definito un messaggio di risposta, questo verrà elaborato dall'oggetto proxy e verrà restituita una risposta all'applicazione.

Gestione dei riferimenti Web

È possibile rinominare o modificare i riferimenti Web oppure aggiornarli se il servizio Web cui viene fatto riferimento è stato modificato. Per ulteriori informazioni, vedere Procedura: rinominare un riferimento Web a un progetto e Procedura: aggiornare un riferimento Web a un progetto.

Proprietà Comportamento URL

Ogni riferimento Web nel progetto interagisce con una classe proxy utilizzata per accedere al servizio Web. È possibile utilizzare la proprietà URL del riferimento Web per specificare l'URL del servizio Web XML. In ASP.NET 1.1, per un riferimento Web è possibile utilizzare un URL statico o dinamico. In ASP.NET 2.0 e versioni successive, un riferimento Web ottiene dinamicamente l'URL. Per ulteriori informazioni, vedere Individuazione di servizi Web.

Quando si crea un riferimento Web in Visual Studio utilizzando la finestra di dialogo Aggiungi riferimento Web, per impostazione predefinita questa proprietà viene impostata sull'URL del servizio Web XML selezionato, che è statico. Se viene mantenuto il valore statico predefinito per il comportamento dell'URL, nella classe proxy la proprietà URL verrà impostata mediante un URL stabilito a livello di codice durante la creazione di un'istanza della classe.

Se il comportamento dell'URL del riferimento Web viene invece impostato come dinamico, in fase di esecuzione l'URL verrà ottenuto dall'elemento appSettings del file di configurazione dell'applicazione.

Vedere anche

Condividi tramite

Riferimenti Web in Visual Studio

Gestione dei riferimenti Web

Proprietà Comportamento URL

Vedere anche

Attività

Concetti

Riferimenti

Risorse aggiuntive