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. |
.gif "ms187832.note(de-de,SQL.90).gif") 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