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

Depois que você criar um novo projeto de site usando o modelo de site ASP.NET para o Visual C#, a próxima etapa será criar uma conexão de dados e uma tabela de dados para o relatório pai.

Os exemplos de código neste artigo usam o banco de dados de exemplo AdventureWorks2025 ou AdventureWorksDW2025, que você pode baixar do repositório do GitHub Azure Data SQL Samples Repository.

Definir uma conexão de dados e uma DataTable adicionando um DataSet (para o relatório pai)

1. No menu Site , selecione Adicionar Novo Item.

2. Na caixa de diálogo Adicionar Novo Item, selecione DataSet e escolha Adicionar. Quando o prompt for exibido, você deverá adicionar o item à pasta App_Code selecionando Sim.

   Essa ação adicionará um novo arquivo XSD DataSet1.xsd ao projeto e abrirá o Designer de Conjunto de Dados.

3. Na janela Caixa de Ferramentas, arraste um controle TableAdapter até a superfície de design. Essa ação inicializará o Assistente de Configuração do TableAdapter.

4. Na página Escolher a Conexão de Dados , clique em Nova Conexão.

5. Se esta lição for a primeira vez que você está criando uma fonte de dados no Visual Studio, consulte a página Escolher fonte de dados. Na caixa Fonte de Dados , selecione Microsoft SQL Server.

6. Na caixa de diálogo Adicionar Conexão , realize as seguintes etapas:

   1. Na caixa Nome do servidor, insira o servidor em que o banco de dados AdventureWorks2025 está localizado.

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

   2. Na seção Fazer logon no servidor , selecione a opção que lhe fornece acesso aos dados. Usar Autenticação do Windows é o padrão.

   3. Na lista suspensa Selecionar ou inserir um nome de banco de dados, selecione AdventureWorks2025.

   4. Selecione OK e, em seguida, escolha Avançar.

7. Se você tiver selecionado Usar Autenticação do SQL Server na Etapa 6 (b), selecione a opção que especificará se os dados confidenciais serão incluídos na cadeia de caracteres ou defina as informações no código do aplicativo.

8. Na página Salvar a Cadeia de Conexão no Arquivo de Configuração do Aplicativo , digite o nome da cadeia de conexão ou aceite o AdventureWorks2022ConnectionStringpadrão. Selecione Avançar.

9. Na página Escolher um Tipo de Comando , selecione Usar Instruções SQL e escolha Avançar.

10. Na página Inserir uma Instrução SQL, insira a consulta Transact-SQL a seguir para recuperar dados do banco de dados AdventureWorks2025 e selecione Avançar.

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

    Você também pode criar a consulta clicando em Construtor de Consultas e depois verificar a consulta escolhendo Executar Consulta.

11. Na página Escolher os Métodos a Serem Gerados , lembre-se de desmarcar Crie métodos para enviar atualizações diretamente ao banco de dados (GenerateDBDirectMethods)e selecione Concluir.

    Aviso

    Lembre-se de desmarcar a opção Criar métodos para enviar atualizações diretamente ao banco de dados (GenerateDBDirectMethods)

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

12. Salve o arquivo.

13. Para visualizar os dados, selecione Visualizar Dados no menu Dados e escolha Visualizar.

Próxima etapa