Share via


Schreiben einer Visual Studio 2005-Clientanwendung

Diese Funktion wird in zukünftigen Versionen von Microsoft SQL Server nicht mehr bereitgestellt. Verwenden Sie diese Funktion beim Entwickeln neuer Anwendungen nicht, und planen Sie das Ändern von Anwendungen, in denen es zurzeit verwendet wird.

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 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 Webdiensts 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 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 zurückgegeben wird.

SqlParameter (ein durch das WSDL definierter benutzerdefinierter Typ)

Enthält die Auflistung der Ausgabeparameter, die durch die Instanz von SQL Server zurückgegeben werden.

HinweisHinweis

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).