Schreiben einer Visual Studio 2005-Clientanwendung

Durch Verwenden des Webverweismechanismus in Visual Studio 2005 können Sie gespeicherte Prozeduren, benutzerdefinierte Funktionen oder die sqlbatch-Methode für Ad-hoc-Abfragen aufrufen, so wie Sie jede andere Methode für ein Objekt in Ihrer Anwendung aufrufen können.

Senden von SOAP-Anforderungen

Wenn Sie einen Visual Studio 2005-Client zum Senden von SOAP-Anforderungen an die Instanz von SQL Server 2005 verwenden, müssen Sie zunächst dem Projekt einen Webverweis hinzufügen und die URL des WSDL-Dokuments angeben, beispielsweise: https://server/sql2?wsdl, wobei https://server/sql2 die URL ist, die für den Endpunkt angegeben ist, der mithilfe von CREATE ENDPOINT definiert wurde.

Als Reaktion erstellt Visual Studio eine Webdienst-Proxyklasse und fügt diese Ihrem Projekt hinzu. Diese Proxyklasse legt die Methoden des Webdienstes offen, der durch das angegebene WSDL-Dokument definiert wird. Durch Verwenden dieser Proxyklasse können Sie jede der durch den Endpunkt offen gelegten Methoden aufrufen. Wenn der Endpunkt Ad-hoc-Abfrageanforderungen zulässt, schließt das WSDL-Dokument die sqlbatch-Methode ein, die Sie zum Angeben von Ad-hoc-SQL-Abfragen verwenden können. Intern wird eine SOAP-Anforderung an die Instanz von SQL Server 2005 gesendet. Diese führt die Methode aus und gibt das Ergebnis (die SOAP-Antwort) an den Client zurück.

Verarbeiten der Antwort

Das Ergebnis einer Operation kann in Form eines Objektarrays zurückgegeben werden. Die folgende Tabelle listet die möglichen Typen der Arrayelemente auf und beschreibt diese.

Typen	Beschreibung
XMLElement( System.Xml.XmlElement)	Enthält das Ergebnis einer SELECT... FOR XML-Abfrage.
DataSet (System.Data.DataSet)	Enthält das Ergebnis einer SELECT-Abfrage.
SqlMessage (ein durch das WSDL definierter benutzerdefinierter Typ)	Enthält Fehler-, Warn- und andere Informationsmeldungen, die zurückgegeben werden.
SqlRowCount (ein durch das WSDL definierter benutzerdefinierter Typ)	Enthält die Zeilenzählung (Anzahl der von der Abfrage betroffenen Zeilen), die von der Instanz von SQL Server 2005 zurückgegeben wird.
SqlParameter (ein durch das WSDL definierter benutzerdefinierter Typ)	Enthält die Auflistung der Ausgabeparameter, die durch die Instanz von SQL Server 2005 zurückgegeben werden.

Hinweis:
Wird eine gespeicherte Prozedur ausgeführt, erfolgt die Rückgabe des Rückgabecode-Wertes als Arrayelement des Typs integer.

Weil Objektarrayelemente jeden der vorherigen Typen haben können, müssen Sie zunächst den Typ eines Objekts bestimmen und es anschließend entsprechend verarbeiten. Informationen hierzu finden Sie unter Senden von SOAP-Anforderungen mithilfe des Visual Studio 2005-Clients (C#) und Senden von SOAP-Anforderungen mithilfe des Visual Studio 2005-Clients (Visual Basic).

Siehe auch

Verweis

Festlegen, dass der Server Anforderungen systemeigener XML-Webdienste überwacht
Struktur der SOAP-Anforderungs- und -Antwortnachrichten
Beispielanwendungen für das Senden systemeigener XML-Webdiensteanforderungen
Richtlinien und Einschränkungen für die Verwendung der systemeigenen XML-Webdienste

Andere Ressourcen

Schreiben von Clientanwendungen

Hilfe und Informationen

Informationsquellen für SQL Server 2005