Como: Executar um procedimento armazenado que retorna linhas

Artigo
08/25/2010

Para executar um procedimento armazenado que não retorna um valo, você pode executar uma consulta TableAdapter que esteja configurada para executar um procedimento armazenado (por exemplo, CustomersTableAdapter.Fill(CustomersDataTable)).

Se seu aplicativo não usa TableAdapters, chame o método ExecuteReader em um objeto de comando, definindo sua propriedade CommandType como StoredProcedure.("Objeto de comando" refere-se ao comando específico para o .NET Framework Data Provider que seu aplicativo está usando.Por exemplo, se seu aplicativo estiver usando provedor de dados do .NET Framework para SQL Server, o objeto de comando seria SqlCommand.)

Os exemplos a seguir mostram como executar procedimentos armazenados que retornam linhas de um banco de dados usando o TableAdapters ou objetos de comando.Para obter mais informações sobre como consultar com TableAdapters e comandos, consulte Preenchendo DataSets e consultando dados de uma forma geral.

Observação:
As caixas de diálogo e comandos de menu consulte migh t diferir daqueles descritos na Ajuda dependendo das configurações ativas ou edição.Para alterar as configurações, escolher Importar e exportar configurações on the Ferramentas menu.Para obter mais informações, consulte Configurações do Visual Studio.

Executar Procedimentos Armazenados que Retornam Linhas Usando um TableAdapter

Este exemplo mostra como criar uma consulta TableAdapter usando o Assistente de configuração da consulta TableAdapter, e em seguida, ele fornece informações sobre como declarar uma instância do TableAdapter e executar a consulta.

Para criar um procedimento armazenado retornando linhas usando um TableAdapter

Abra um dataset no Dataset Designer.Para obter mais informações, consulte Como: Abra um Dataset no Designer de Conjunto de Dados de Conjunto de Dados.
Se você não tiver um, crie um TableAdapter.Para obter mais informações, consulte Como: Crie TableAdapters.
Se você já tiver uma consulta no seu TableAdapter que chama um procedimento armazenado que retorna linhas, vá para o procedimento seguinte, " Para declarar uma instância do TableAdapter e executar a consulta ". Caso contrário, prossiga com a etapa 4 para criar uma nova consulta que chama um procedimento armazenado que retorna linhas.
Clique com o botão direito do mouse no TableAdapter que você quer e use o menu de atalho para adicionar uma consulta.

The Assistente de configuração da consulta TableAdapter opens.
Clique em Next, escolha Use existing stored procedure e clique Next.
Selecione um procedimento armazenado na lista suspensa, e clique em Next.
Deixe o valor padrão de Tabular data e clique Next.
Fornece nomes para cada método que deseja criar (métodos Fill a DataTable e / ou Return a DataTable.)
Conclua o assistente; a consulta é adicionada ao TableAdapter.
Crie seu projeto.

Para declarar uma instância do TableAdapter e executar a consulta

Declare uma instância do TableAdapter que contém a consulta que você deseja executar.

Para criar uma instância usando ferramentas em tempo de design, arraste o TableAdapter que você deseja a partir da Toolbox.(Os componentes no seu projeto agora aparecem no Toolbox sob um título que coincide com o nome do projeto.) Se o TableAdapter não aparecer no Toolbox, então você talvez precise criar seu projeto.

- ou -

Para criar uma instância no código, substitua o código a seguir pelos nomes de seu DataSet e TableAdapter.

Dim tableAdapter As New DataSetTableAdapters.TableAdapter

Observação:
Na verdade os TableAdapters não estão localizados dentro de suas classes dataset associadas.Cada dataset tem uma coleção correspondente de TableAdapters no seu próprio namespace.Por exemplo, se você tiver um dataset chamado SalesDataSet, haveria uma SalesDataSetTableAdapters namespace que contém seus TableAdapters.

Chame sua consulta como você chamaria qualquer outro método no código.Sua consulta é um método no TableAdapter.Substitua o código a seguir pelos nomes de seu TableAdapter e de sua consulta.Você também precisa passar em quaisquer parâmetros necessários para sua consulta.Se você não tiver certeza se sua consulta requer parâmetros, ou que parâmetros requer, então, verifique o IntelliSense para a assinatura necessária da consulta.Dependendo se sua consulta usa parâmetros ou não, o código seria de aparência semelhante a um dos exemplos a seguir:

TableAdapter.Query()

TableAdapter.Query(Parameters)

TableAdapter.Query(DataTable, Parameters)

O código completo para declarar uma instância do TableAdapter e executar a consulta deve ser semelhante ao seguinte:
```
Dim tableAdapter As New NorthwindDataSetTableAdapters.CustomersTableAdapter()
tableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle")
```
```
NorthwindDataSetTableAdapters.CustomersTableAdapter tableAdapter = 
    new NorthwindDataSetTableAdapters.CustomersTableAdapter();

tableAdapter.FillByCity(northwindDataSet.Customers, "Seattle");
```

Executar Procedimentos Armazenados que Retornam Linhas Usando um Objeto de Comando

O exemplo a seguir mostra como criar um comando e executar um procedimento armazenado que retorna linhas.Para obter informações sobre configurar e obter valores de parâmetro para um comando, consulte Como: conjunto e Get Parameters for Command Objects.

Este exemplo usa o objeto SqlCommand e requer:

Referências aos namespaces System, System.Data e System.Xml.
Uma conexão de dados denominada SqlConnection1.
Uma tabela denominada Customers na fonte de dados à qual SqlConnection1 se conecta.(Caso contrário, você precisa de uma instrução SQL válida para sua fonte de dados).

Para executar um procedimento armazenado retornando linhas programaticamente usando um objeto de comando

Adicione o seguinte código para um método a partir do código que você deseja executar.Você retorna linhas chamando o método ExecuteReader do comando (por exemplo, ExecuteReader).Os dados são retornados em um DataReader.Para obter mais informações sobre acessar os dados em um DataReader, consulte Recuperando dados usando um DataReader .

Dim sqlConnection1 As New SqlConnection("Your Connection String")
Dim cmd As New SqlCommand
Dim reader As SqlDataReader

cmd.CommandText = "StoredProcedureName"
cmd.CommandType = CommandType.StoredProcedure
cmd.Connection = sqlConnection1

sqlConnection1.Open()

reader = cmd.ExecuteReader()
' Data is accessible through the DataReader object here.

sqlConnection1.Close()

SqlConnection sqlConnection1 = new SqlConnection("Your Connection String");
SqlCommand cmd = new SqlCommand();
SqlDataReader reader;

cmd.CommandText = "StoredProcedureName";
cmd.CommandType = CommandType.StoredProcedure;
cmd.Connection = sqlConnection1;

sqlConnection1.Open();

reader = cmd.ExecuteReader();
// Data is accessible through the DataReader object here.

sqlConnection1.Close();

Segurança

O aplicativo requer permissão para acessar o banco de dados e executar o procedimento armazenado.

Consulte também

Como: Executar um procedimento armazenado que retorna linhas

Executar Procedimentos Armazenados que Retornam Linhas Usando um TableAdapter

Para criar um procedimento armazenado retornando linhas usando um TableAdapter

Para declarar uma instância do TableAdapter e executar a consulta

Executar Procedimentos Armazenados que Retornam Linhas Usando um Objeto de Comando

Para executar um procedimento armazenado retornando linhas programaticamente usando um objeto de comando

Segurança

Consulte também

Tarefas

Conceitos

Referência

Recursos adicionais