Riferimenti Web e classi proxy client personalizzate di servizi Web in librerie di classi
Aggiornamento: novembre 2007
In Progettazione applicazioni è possibile rappresentare riferimenti Web a servizi Web o rappresentare classi personalizzate proxy client di servizi Web che sono definiti in progetti o in assembly a cui viene fatto riferimento, come ad esempio endpoint di tipo consumer di servizi Web su applicazioni Windows, Office o ASP.NET. Per effettuare questa operazione è necessario seguire una procedura per visualizzare tali elementi come tipi indiretti di endpoint consumer di servizi Web e connessioni a questi stessi endpoint.
.gif "Nota") Nota: |
|---|
Per aggiungere endpoint di tipo consumer di servizi Web per rappresentare questi elementi non è possibile connettere direttamente l'applicazione consumer a un endpoint di tipo provider di servizi Web e spostare questi elementi in una libreria di classi. |
Prima di eseguire la procedura è tuttavia necessario implementare l'applicazione consumer di servizi Web; inoltre il progetto dell'applicazione deve contenere un file di configurazione dell'applicazione (Web.config o App.config). Per ulteriori informazioni, vedere Implementazione di applicazioni su diagrammi applicazione.
Requisiti per la decodifica del codice compilato di riferimenti Web e classi personalizzate proxy client di servizi Web in librerie di classi
Nel caso di applicazioni ASP.NET è necessario aggiungere le voci adeguate al file di configurazione Web.config; le classi proxy con corrispondenti nomi completi devono esistere e poter essere trovate. In applicazioni Windows e Office, invece, è sufficiente che tali voci esistano nel file di configurazione App.config e che siano designate come tipo WebServiceURL. Se tuttavia tali voci non sono designate con il tipo WebServiceURL o se sono designate con il tipo String, anche le classi proxy con nomi corrispondenti e completi dovranno esistere ed essere trovate. Per ulteriori informazioni, vedere Considerazioni sulle classi proxy client personalizzate del servizio Web.
Quando un'applicazione consumer di servizi Web fa riferimento a librerie di classi in cui sono definiti riferimenti Web o classi personalizzate proxy client di servizi Web, è necessario aggiungere un riferimento di progetto al progetto dell'applicazione consumer di servizi Web. Tuttavia, dato che le impostazioni nel file di configurazione della libreria di classi saranno sostituite da quelle nel file di configurazione del progetto dell'applicazione, per utilizzare le impostazioni create nel file di configurazione della libreria di classe è necessario copiarle nel file di configurazione dell'applicazione consumer. Per ulteriori informazioni, vedere Procedura: fare riferimento a librerie di classi da applicazioni nei diagrammi applicazioni.
Dopo aver completato queste operazioni, tali voci del file di configurazione verranno decodificate come endpoint di tipo consumer di servizi Web. Se gli URL dei servizi Web specificati in queste voci corrispondono agli URL di endpoint di tipo provider di servizi Web esistenti, verranno visualizzate anche le connessioni tra gli endpoint di tipo consumer e provider. Se non esiste alcun endpoint di tipo provider di servizi Web corrispondente, ma è possibile individuare un file WSDL valido tramite l'URL, aggiungendo "?wsdl" o "?disco" al medesimo URL, un servizio Web esterno sarà aggiunto al diagramma applicazioni e verrà connesso all'endpoint di tipo consumer di servizi Web. Se è impossibile individuare un file WSDL utilizzando l'URL, l'endpoint di tipo consumer di servizi Web resterà non connesso.
Modifiche che influiscono su endpoint indiretti di tipo consumer di servizi Web
Certe modifiche influiscono su endpoint indiretti di tipo consumer di servizi Web e sulle relative connessioni come illustrato di seguito:
La creazione o l'eliminazione di connessioni a endpoint indiretti di tipo consumer di servizi Web dal diagramma applicazioni comporta l'aggiunta o la rimozione dell'URL del servizio Web connesso dal file di configurazione dell'applicazione consumer.
L'eliminazione di endpoint indiretti di tipo consumer di servizi Web dal diagramma applicazioni comporta l'eliminazione delle corrispondenti voci del file di configurazione, ma non dei riferimenti Web o delle classi proxy personalizzate dalle librerie di classi.
Nota:Se si elimina un endpoint indiretto, assicurarsi che l'applicazione e tutte le librerie di classi a cui esistono riferimenti non facciano più riferimento alla corrispondente voce del file di configurazione.
L'eliminazione o la ridenominazione di una classe proxy in un progetto o assembly a cui fa riferimento un'applicazione ASP.NET comporta l'eliminazione del corrispondente endpoint di tipo consumer di servizi Web,
in quanto la voce del file di configurazione non corrisponde più a una classe proxy. Se si ricrea una classe proxy con un nome corrispondente, l'endpoint di tipo consumer sarà nuovamente visualizzato.
Se l'endpoint di tipo consumer di servizi Web i cui riferimenti Web risiedono in una libreria di classe o in un'assembly vengono copiati e incollati, i riferimenti Web degli endpoint incollati saranno visualizzati nel progetto principale.
Vedere anche
Riferimenti
Considerazioni sulle classi proxy client personalizzate del servizio Web
Altre risorse
Riferimento alle librerie di classi da applicazioni in diagrammi applicazioni