Lição 2: Defina uma conexão de dados e uma tabela de dados para o relatório principal

Depois de criar um novo projeto de website usando o modelo ASP.NET para Visual C#, o próximo passo é criar uma conexão de dados e uma tabela de dados associada ao relatório principal.

Os exemplos de código neste artigo usam o banco de dados de exemplo AdventureWorks2025 ou AdventureWorksDW2025, que pode ser descarregado da página inicial de Exemplos e Projetos da Comunidade do Microsoft SQL Server.

Defina uma ligação de dados e uma tabela de dados adicionando um DataSet (para o relatório pai)

1. No menu do Website, selecione Adicionar Novo Item.

2. Na caixa de diálogo Adicionar Novo Item , selecione DataSet e selecione Adicionar. Quando vir o prompt, deve adicionar o item à pasta App_Code selecionando Sim.

   Esta ação adiciona um novo ficheiro XSD, DataSet1.xsd , ao projeto e abre o DataSet Designer.

3. A partir da janela Toolbox, arraste um controlo TableAdapter para a superfície de design. Esta ação inicia o Assistente de Configuração do TableAdapter .

4. Na página Escolha a Sua Ligação de Dados , selecione Nova Ligação.

5. Se esta lição for a sua primeira vez a criar uma fonte de dados no Visual Studio, deve consultar a página Escolher Fonte de Dados . Na caixa Data Source , selecione Microsoft SQL Server.

6. Na caixa de diálogo Adicionar Ligação , execute os seguintes passos:

   1. Na caixa de nome do servidor , introduza o servidor onde a AdventureWorks2025 base de dados está localizada.

      A instância padrão do SQL Server Express é (local)\sqlexpress.

   2. Na secção Iniciar sessão no servidor , selecione a opção que lhe dá acesso aos dados. Use a Autenticação do Windows é o padrão.

   3. A partir da lista suspensa Selecionar ou inserir nomes de base de dados , selecione AdventureWorks2025.

   4. Seleciona OK e depois escolhe Próximo.

7. Se selecionou Usar Autenticação SQL Server no Passo 6 (b), selecione a opção de incluir os dados sensíveis na cadeia ou definir a informação no código da sua aplicação.

8. Na página Guardar a String de Ligação no Ficheiro de Configuração da Aplicação, escreva o nome da cadeia de ligação ou aceite o AdventureWorks2022ConnectionString por defeito. Selecione Avançar.

9. Na página Escolher um Tipo de Comando , selecione Usar Instruções SQL e depois selecione Próximo.

10. Na página Enter a SQL Statement , introduza a seguinte consulta Transact-SQL para recuperar dados da AdventureWorks2025 base de dados e depois selecione Próximo.

    SELECT ProductID, Name, ProductNumber, SafetyStockLevel, ReorderPoint FROM  Production.Product Order By ProductID  
    

    Também pode criar a consulta selecionando Query Builder e depois verificar a consulta escolhendo Executar Consulta.

11. Na página Escolher Métodos para Gerar , certifique-se de desmarcar Criar métodos para enviar atualizações diretamente à base de dados (GenerateDBDirectMethods) e depois selecione Terminar.

    Advertência

    Certifique-se de desmarcar Criar métodos para enviar atualizações diretamente para a base de dados (GenerateDBDirectMethods)

    Configurou o objeto ADO.NET DataTable como fonte de dados para o seu relatório. Na página DataSet Designer no Visual Studio, deverá ver o objeto DataTable que adicionou, listando as colunas especificadas na consulta. O DataSet1 contém os dados da tabela Produto, com base na consulta.

12. Salve o arquivo.

13. Para pré-visualizar os dados, selecione Pré-visualização de Dadosno menu Dados e depois selecione Pré-visualização.

Próximo passo