Compartilhar via

  • Artigo

Escrevendo um aplicativo cliente do Visual Studio 2005

Esse recurso será removido em uma versão futura do Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam.

Usando o mecanismo de referência da Web no Visual Studio 2005, você pode chamar procedimentos armazenados, funções definidas pelo usuário ou o método sqlbatch para consultas ad hoc, da mesma forma que chamaria qualquer outro método em um objeto em seu aplicativo.

Enviando solicitações SOAP

Ao usar um cliente Visual Studio 2005 para enviar solicitações SOAP para uma instância do SQL Server, primeiro você deve adicionar uma referência da Web ao projeto e especificar a URL do documento WSDL, por exemplo: https://server/sql2?wsdl, onde https://server/sql2 é a URL especificada para o ponto de extremidade que foi definido usando CREATE ENDPOINT.

Em resposta, o Visual Studio cria uma classe proxy de Serviço Web e a adiciona ao seu projeto. Esta classe proxy expõe os métodos do serviço Web definidos pelo documento WSDL especificado. Usando essa classe proxy, você pode invocar qualquer dos métodos expostos pelo ponto de extremidade. Se o ponto de extremidade permitir solicitações de consultas ad hoc, o documento WSDL incluirá o método sqlbatch que pode ser usado para especificar consultas SQL ad hoc. Internamente, uma solicitação SOAP é enviada à instância do SQL Server. Ele executa o método e retorna o resultado (a resposta SOAP) para o cliente.

Processando a resposta

O resultado de uma operação pode ser retornado como uma matriz de objetos. A tabela a seguir lista e descreve os possíveis tipos dos elementos da matriz.

Tipos

Descrição

XMLElement (System.Xml.XmlElement)

Mantém os resultados de uma consulta XML SELECT... FOR.

DataSet (System.Data.DataSet)

Mantém os resultados de uma consulta SELECT.

SqlMessage (um tipo personalizado definido pelo WSDL)

Mantém erros, avisos e outras mensagens informativas que são retornados.

SqlRowCount (um tipo personalizado definido pelo WSDL)

Mantém a contagem de linhas (número de linhas afetadas pela consulta) que é retornada pela instância do SQL Server.

SqlParameter (um tipo personalizado definido pelo WSDL)

Mantém a coleção de parâmetros de saída retornada pela instância do SQL Server.
ObservaçãoObservação

Quando um procedimento armazenado é executado, o valor do código de retorno é retornado como um elemento de matriz do tipo inteiro.

Como os elementos da matriz de objetos podem ser de qualquer dos tipos anteriores, primeiro é necessário determinar o tipo de um objeto para depois processá-lo apropriadamente. Para obter exemplos de funcionamento, consulte Enviando solicitações SOAP usando o cliente Visual Studio 2005 (C#) e Enviando solicitações SOAP usando o cliente Visual Studio 2005 (Visual Basic).