Considerazioni sulla decodifica nelle soluzioni esistenti

Articolo
09/12/2008

Aggiornamento: novembre 2007

In Visual Studio Team System Architecture Edition, è possibile definire applicazioni e progettare sistemi di applicazioni in una soluzione esistente di Visual Studio utilizzando gli strumenti di progettazione di sistemi distribuiti. È possibile eseguire quest'attività aggiungendo alla soluzione un diagramma applicazioni o un diagramma sistema. Quando viene eseguita questa attività, in Visual Studio viene decodificata la soluzione e le definizioni di applicazione vengono aggiunte al diagramma applicazioni per i progetti appropriati nella soluzione. È quindi possibile utilizzare Progettazione applicazioni per visualizzare, definire, configurare e implementare le applicazioni. È possibile utilizzare Progettazione sistemi per progettare sistemi di applicazioni. Per ulteriori informazioni, vedere Procedura: aggiungere diagrammi applicazioni alle soluzioni e Procedura: aggiungere diagrammi sistema alle soluzioni.

Nelle sezioni seguenti vengono descritte modifiche aggiuntive che è possibile apportare a elementi decodificati in soluzioni esistenti. In queste sezioni vengono inoltre descritti gli elementi che non supportano la decodifica:

Decodifica nelle soluzioni esistenti
Elementi che non supportano la decodifica

È anche possibile aggiornare la soluzione da una versione precedente di Architecture Edition. Comunque, questa versione non supporta i progetti Visual J#. Per ulteriori informazioni, vedere Aggiornamento di versioni precedenti di Architecture Edition.

Decodifica nelle soluzioni esistenti

Dopo avere aggiunto un diagramma applicazioni alla soluzione, Visual Studio esegue la decodifica di alcune modifiche effettuate alla soluzione o ai progetti nella soluzione. Se aperto, il diagramma visualizzerà queste modifiche, altrimenti esse verranno visualizzate alla successiva apertura:

Aggiungere un progetto per un tipo di applicazione supportato dal diagramma applicazioni.

È possibile decodificare qualsiasi progetto per un tipo di applicazione supportato dal diagramma applicazioni. Una forma di definizione dell’applicazione per quel progetto verrà visualizzata sul diagramma applicazioni.

Quando si decodificano progetti, è necessario tenere presenti le seguenti considerazioni:
- Se non si possiedono i privilegi sufficienti per l’accesso alla Metabase IIS, non è possibile decodificare i progetti Web ASP.NET sul diagramma applicazioni.
- La proprietà Versione .NET Framework di destinazione di un'applicazione decodificata risulta vuota e in sola lettura. È possibile visualizzare e modificare la versione del framework di destinazione nelle proprietà del progetto. Per impostazione predefinita, in Visual Studio l'impostazione Versione .NET Framework di destinazione dell'applicazione risultante viene impostata su .NET Framework 3.5. Verificare questa impostazione e aggiornarla se necessario. Se si desidera modificare queste impostazioni è necessario tenere presente alcune considerazioni. Per ulteriori informazioni, vedere Procedura: scegliere la versione di .NET Framework per le applicazioni.
- Se si decodifica un progetto Office, la proprietà Modello dell'applicazione risultante apparirà vuota e di sola lettura. Tuttavia, l'impostazione Versione di Office dell'applicazione rispecchierà la versione di Office utilizzata dal progetto. Per ulteriori informazioni, vedere Procedura: modificare i modelli di progetto delle applicazioni.
- Sei WSE (Web Services Enhancement) non è installato e si decodifica o si apre un progetto di un servizio Web che è abilitato con impostazioni WSE (Web Service Enhancement) all’interno di una soluzione che contiene un diagramma applicazioni, Il diagramma applicazioni verrà bloccato.
  
  Per risolvere questo problema, chiudere il diagramma, installare WSE, quindi aprire nuovamente il diagramma. Per ulteriori informazioni, vedere Risoluzione dei problemi relativi ai diagrammi applicazioni.
Per ulteriori informazioni, vedere i seguenti argomenti:
- Procedura: decodificare progetti nelle soluzioni esistenti.
- Elementi che non supportano la decodifica
- Tipi e prototipi di applicazione per la definizione delle applicazioni
Aggiunta di un servizio Web al progetto di un'applicazione ASP.NET nel diagramma applicazioni.

Visual Studio aggiunge un endpoint provider di servizi Web .NET alla corrispondete definizione dell'applicazione ASP.NET sul diagramma applicazioni. Visual Studio aggiunge inoltre al progetto nella soluzione un file con estensione .asmx ed un file della classe del servizio Web. Per ulteriori informazioni, vedere Cenni preliminari sulle applicazioni ASP.NET nei diagrammi applicazioni.
Aggiungere un metodo Web ad un file di classe del servizio Web in un progetto di applicazione ASP.NET.

Visual Studio aggiunge un’operazione al corrispondente endpoint provider di servizi Web .NET corrispondente nella definizione dell'applicazione ASP.NET sul diagramma applicazioni. Tale operazione può quindi essere visualizzata o modificata nella finestra Dettagli servizio Web.

Per ulteriori informazioni, vedere i seguenti argomenti:
Aggiunta, modifica o eliminazione di attributi o proprietà relativi a metodi Web, servizi Web oppure WSDL contenuti nel file di classe di servizio Web sottostante un endpoint di tipo provider del servizio Web .NET in una definizione di applicazione ASP.NET.

Visual Studio aggiorna l’operazione corrispondente e tutte le proprietà appropriate nella finestra dettagli servizio Web. Per ulteriori informazioni, vedere Procedura: modificare le operazioni per i servizi Web ASP.NET.
Aggiunta, modifica o eliminazione di voci dei file di configurazione dell'applicazione.

Visual Studio aggiorna le impostazioni memorizzate nei documenti SDM (System Definition Model) e nell’Editor impostazioni e vincoli. Per ulteriori informazioni, vedere Cenni preliminari su SDM (System Definition Model) e Editor impostazioni e vincoli.

Aggiunta di voci per classi proxy client personalizzate del servizio Web o per librerie di classi contenenti riferimenti Web e classi proxy client personalizzate del servizio Web al file di configurazione di un progetto applicazione.

Una classe proxy client personalizzata del servizio Web è una classe proxy creata manualmente, non associata a un riferimento Web nel progetto di applicazione. Una definizione dell'applicazione visualizza un endpoint di tipo consumer del servizio Web per ogni riferimento Web o classe proxy personalizzata solo quando vengono aggiunte le voci adatte al file di configurazione dell'applicazione.

Nota:
Se nel diagramma applicazioni esistono gli appropriati endpoint di tipo provider del servizio Web .NET, vengono visualizzate le connessioni fra gli endpoint di tipo consumer e gli endpoint di tipo provider del servizio Web. In caso contrario, vengono visualizzati dei nuovi servizi Web esterni che vengono connessi agli endpoint di tipo consumer del servizio Web.

Per ulteriori informazioni, vedere i seguenti argomenti:

Aggiunta nella soluzione di un riferimento Web a un progetto di applicazione.

Quando si aggiunge un riferimento Web al progetto di un’applicazione, Visual Studio connette tale applicazione ad un servizio Web ASP.NET esistente o a servizio Web esterno, nuovo o esistente, in base alla capacità del diagramma applicazioni di supportare il tipo di applicazione specifico e l’URL del servizio Web specificato dal riferimento Web.

Per ulteriori informazioni, vedere i seguenti argomenti:
- Procedura: aggiungere e rimuovere riferimenti Web
- Tipi e prototipi di applicazione per la definizione delle applicazioni
Aggiunta di una voce di connessione di database al file di configurazione di un'applicazione.

È ad esempio possibile aggiungere una connessione ad un database al file Web.config di un'applicazione ASP.NET oppure al file App.config di un'applicazione di Microsoft Windows o Microsoft Office.

Visual Studio aggiunge all'applicazione nel diagramma applicazioni un endpoint di tipo consumer del database. È quindi possibile connettere tale endpoint di tipo consumer a un database esterno esistente o a un nuovo database esterno aggiunto al diagramma. Dall'endpoint di tipo consumer del database è possibile visualizzare o modificare le impostazioni di connessione di database. Per ulteriori informazioni, vedere Procedura: configurare connessioni a database esterni.

Elementi che non supportano la decodifica

Il supporto per la decodifica è limitato o assente in Progettazione applicazioni per elementi delle seguenti categorie:

Progetti di applicazione
- Progettazione applicazioni non supporta la progettazione e la rappresentazione diretta di librerie di classi.
  
  È possibile utilizzare un servizio Web ASP.NET come facciata per la funzionalità implementata da una libreria di classi. In questo modo è possibile rappresentare l'interazione fra una libreria di classi a cui fa riferimento un'applicazione ASP.NET e le applicazioni che supportano l'implementazione nel diagramma applicazioni. Per ulteriori informazioni, vedere Procedura: fare riferimento a librerie di classi da applicazioni nei diagrammi applicazioni. Inoltre, se si aggiungono le voci appropriate nel file di configurazione dell'applicazione consumer, è possibile visualizzare come endpoint di tipo consumer del servizio Web i riferimenti Web ai servizi Web e le classi proxy client personalizzate del servizio Web contenute nelle librerie di classi. Per ulteriori informazioni, vedere Riferimenti Web e classi proxy client personalizzate di servizi Web in librerie di classi.
- Progettazione applicazioni non supporta la decodifica di progetti sito Web basati su FTP o su Microsoft SharePoint. Progettazione applicazioni supporta la decodifica dei soli progetti sito Web che sono in esecuzione su Internet Information Services (IIS) o sul server di sviluppo ASP.NET.

Servizi Web ASP.NET

Definizioni di classi di servizio Web definite inline nei file ASMX.

La finestra Dettagli servizio Web non visualizzerà le operazioni corrispondenti per i metodi Web associati ad un servizio Web ASP.NET se gli stessi non sono completamente dichiarati da una singola definizione della classe in un file di codice separato o un file "code-behind". È comunque possibile visualizzare il servizio Web come un endpoint del servizio Web .NET nell'applicazione ASP.NET e collegarvi le applicazioni consumer. Tuttavia, l'endpoint di tipo provider del servizio Web .NET verrà visualizzato con un'icona di avviso (!). Per ulteriori informazioni, vedere Risoluzione dei problemi relativi ai diagrammi applicazioni.

Nota:

Il file code-behind è un file di classe specifico del linguaggio che in genere si trova nella cartella del codice dell'applicazione del progetto associato all'applicazione ASP.NET.
Metodi Web dichiarati mediante attributi nei metodi di un'interfaccia implementata da una classe di servizio Web.

-oppure-

una classe estende una classe base che definisce metodi Web.

In questi casi, nella finestra Dettagli servizio Web vengono visualizzate solo le operazioni che corrispondono ai metodi Web dichiarati nella classe cui fa riferimento il file ASMX. Nonostante il fatto che la finestra Dettagli servizio Web non mostri tutte le operazioni del servizio Web, l'endpoint provider di servizi Web .NET verrà comunque visualizzato correttamente sull'applicazione ASP.NET fintantoché il file .asmx esisterà nel progetto di applicazione. Inoltre, anche le connessioni all'endpoint del servizio Web verranno implementate e configurate in modo corretto.

Nota:
Il file code-behind è un file di classe specifico del linguaggio che in genere si trova nella cartella del codice dell'applicazione del progetto associato all'applicazione ASP.NET.

Codice che definisce un servizio Web contenente più associazioni.

Se un file code-behind definisce un servizio Web avente metodi Web relativi ad associazioni distinte, nella finestra Dettagli servizio Web verranno visualizzate solo le operazioni relative alla prima associazione.

Nota:
L'attributo WebServiceBinding dichiara le associazioni al livello del servizio Web. È possibile impostare l'attributo SoapDocumentMethod o SoapRPCMethod per utilizzare queste associazioni a livello del metodo Web. Per ulteriori informazioni, visitare MSDN Library (informazioni in lingua inglese).

File WSDL contenenti più associazioni WSDL o file DISCO che fanno riferimento a più servizi Web.

Gli strumenti di progettazione di sistemi distribuiti supportano solo file WSDL che contengono singole associazioni WSDL e file DISCO che fanno riferimento ad un singolo servizio Web.