Article
09/27/2010

Écriture d'une application cliente Visual Studio 2005

Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité.

Grâce au système de référencement Web de Visual Studio 2005, vous pouvez appeler des procédures stockées, des fonctions définies par l'utilisateur ou la méthode sqlbatch pour des requêtes appropriées, exactement comme vous appelleriez n'importe quelle autre méthode sur un objet de votre application.

Envoi de demandes SOAP

Lorsque vous utilisez un client Visual Studio 2005 pour envoyer des demandes SOAP à une instance de SQL Server, vous devez d'abord ajouter une référence Web au projet et spécifier l'adresse URL du document WSDL, par exemple : https://server/sql2?wsdl, où https://server/sql2 est l'URL spécifiée pour le point de terminaison qui a été défini avec CREATE ENDPOINT.

En réponse, Visual Studio crée une classe proxy de service Web et l'ajoute à votre projet. Cette classe proxy présente les méthodes du service Web définies par le document WSDL spécifié. Grâce à cette classe proxy, vous pouvez appeler une des méthodes proposées par le point de terminaison. Si le point de terminaison accepte les demandes de requêtes appropriées, le document WSDL inclut la méthode sqlbatch que vous pouvez utiliser pour spécifier des requêtes SQL appropriées. En interne, une demande SOAP est envoyée à l'instance de SQL Server. Elle exécute la méthode et retourne le résultat (la réponse SOAP) au client.

Traitement de la réponse

Les résultats d'une opération peuvent être retournés sous la forme de tableau Object. Le tableau suivant énumère et décrit les types d'éléments du tableau.

Types	Description
XMLElement( System.Xml.XmlElement)	Contient les résultats d'une requête SELECT... FOR XML.
DataSet (System.Data.DataSet)	Contient les résultats d'une requête SELECT.
SqlMessage (type personnalisé défini par le document WSDL)	Contient des messages d'erreur, d'avertissement et autres messages d'informations qui sont retournés.
SqlRowCount (type personnalisé défini par le document WSDL)	Contient le nombre de lignes (affectées par la requête) qui est retourné par l'instance de SQL Server.
SqlParameter (type personnalisé défini par le document WSDL)	Contient la collection de paramètres de sortie retournés par l'instance de SQL Server.

[!REMARQUE]

Lors de l'exécution d'une procédure stockée, la valeur return code est retournée sous la forme d'un élément de tableau de type integer.

Comme ces éléments peuvent être de n'importe lequel des types précédents, vous devez d'abord déterminer le type d'un objet, puis le traiter en conséquence. Pour voir des exemples pratiques, consultez Envoi de demandes SOAP à l'aide du client Visual Studio 2005 (C#) et Envoi de demandes SOAP à l'aide du client Visual Studio 2005 (Visual Basic).