• Articolo

Creazione di un'applicazione client di Visual Studio 2005

Questa caratteristica verrà rimossa a partire da una delle prossime versioni di Microsoft SQL Server. Evitare di utilizzare questa caratteristica in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata.

Il meccanismo dei riferimenti Web di Visual Studio 2005 consente di chiamare stored procedure, funzioni definite dall'utente o il metodo sqlbatch per le query ad hoc, esattamente come è possibile chiamare qualsiasi altro metodo per un oggetto dell'applicazione.

Invio di richieste SOAP

Quando si utilizza un client Visual Studio 2005 per inviare richieste SOAP a un'istanza di SQL Server, è necessario innanzitutto aggiungere un riferimento Web al progetto e specificare l'URL del documento WSDL, ad esempio https://server/sql2?wsdl, dove https://server/sql2 è l'URL specificato per l'endpoint definito tramite CREATE ENDPOINT.

Visual Studio crea quindi una classe proxy del servizio Web e la aggiunge al progetto. La classe proxy espone i metodi del servizio Web definiti dal documento WSDL specificato ed è possibile utilizzarla per richiamare uno dei metodi esposti dall'endpoint. Se l'endpoint consente le richieste di query ad hoc, il documento WSDL include il metodo sqlbatch che può essere utilizzato per specificare le query SQL ad hoc. A livello interno, viene inviata una richiesta SOAP all'istanza di SQL Server. Il metodo viene eseguito e il risultato viene restituito al client (risposta SOAP).

Elaborazione della risposta

Il risultato di un'operazione può essere restituito come una matrice Object. Nella tabella seguente sono illustrati e descritti i tipi possibili per gli elementi della matrice.

Tipo

Descrizione

XMLElement( System.Xml.XmlElement)

Contiene i risultati di una query SELECT... FOR XML.

DataSet (System.Data.DataSet)

Contiene i risultati di una query SELECT.

SqlMessage (tipo personalizzato definito dal documento WSDL)

Contiene i messaggi di errore e di avviso e gli altri messaggi informativi restituiti.

SqlRowCount (tipo personalizzato definito dal documento WSDL)

Contiene il conteggio delle righe (numero di righe interessate dalla query) restituito dall'istanza di SQL Server.

SqlParameter (tipo personalizzato definito dal documento WSDL)

Contiene l'insieme di parametri di output restituito dall'istanza di SQL Server.

Nota

Quando viene eseguita una stored procedure, il valore return code viene restituito come un elemento della matrice di tipo integer.

Il tipo degli elementi della matrice Object può essere uno qualsiasi dei precedenti, pertanto è necessario innanzitutto stabilire il tipo di un oggetto e quindi elaborarlo nel modo appropriato. Per esempi reali, vedere Invio di richieste SOAP utilizzando il client di Visual Studio 2005 (C#) e Invio di richieste SOAP utilizzando il client di Visual Studio 2005 (Visual Basic).