Share via


Escribir una aplicación cliente de Visual Studio 2005

Esta característica se quitará en una versión futura de Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan.

Con la ayuda del mecanismo de referencia Web de Visual Studio 2005, puede llamar a los procedimientos almacenados, a las funciones definidas por el usuario o al método sqlbatch para las consultas ad hoc igual que con cualquier otro método en un objeto de su aplicación.

Enviar solicitudes SOAP

Cuando utiliza un cliente Visual Studio 2005 para enviar solicitudes SOAP a una instancia de SQL Server, primero debe agregar una referencia Web al proyecto especificando la dirección URL del documento WSDL. Por ejemplo: https://server/sql2?wsdl, donde https://server/sql2 es la dirección URL especificada para el extremo definido mediante CREATE ENDPOINT.

Como respuesta, Visual Studio crea una clase proxy de servicio Web y la agrega al proyecto. Esta clase proxy expone los métodos al servicio Web definido por el documento WSDL especificado. El uso de esta clase proxy le permite invocar cualquiera de los métodos expuestos por el extremo. Si el extremo permite el uso de solicitudes de consulta ad hoc, el documento WSDL incluye el método sqlbatch que podrá utilizar para especificar las consultas ad hoc de SQL. Internamente, una solicitud SOAP se envía a la instancia de SQL Server. A continuación, ejecuta el método y devuelve el resultado (la respuesta SOAP) al cliente.

Procesar las respuestas

El resultado de una operación puede devolverse como una matriz de objetos. En la siguiente tabla se enumera y describe los diferentes tipos de elementos de una matriz.

Tipos

Descripción

XMLElement( System.Xml.XmlElement)

Retiene los resultados de una consulta SELECT... FOR XML.

DataSet (System.Data.DataSet)

Retiene los resultados de una consulta SELECT.

SqlMessage (tipo personalizado definido por WSDL)

Retiene los mensajes de error, advertencia y otros mensajes informativos que se devuelven.

SqlRowCount (tipo personalizado definido por WSDL)

Retiene el recuento de filas (número de filas afectadas por la consulta) que devuelve la instancia de SQL Server.

SqlParameter (tipo personalizado definido por WSDL)

Retiene el conjunto de parámetros de salida que devuelve la instancia de SQL Server.

[!NOTA]

Cuando se ejecuta un procedimiento almacenado, el valor código devuelto se devuelve como un elemento de matriz de tipo entero.

Puesto que los elementos de matriz de objetos pueden ser de cualquiera de los tipos descritos arriba, primero debe determinar el tipo de un objeto y, a continuación, procesarlo en consecuencia. Para ver algunos ejemplos funcionales, vea Enviar solicitudes SOAP mediante el cliente Visual Studio 2005 (C#) y Enviar solicitudes SOAP mediante el cliente de Visual Studio 2005 (Visual Basic).