Partilhar via


Definir o controle a ser criado quando arrastado da janela Fontes de Dados

Observação

Os conjuntos de dados e as classes relacionadas são tecnologias herdadas do .NET Framework do início dos anos 2000 que permitem que os aplicativos trabalhem com dados na memória enquanto os aplicativos estão desconectados do banco de dados. As tecnologias são bastante úteis em aplicativos que permitem que os usuários modifiquem dados e persistam as alterações no banco de dados. Embora os conjuntos de dados tenham se mostrado uma tecnologia muito bem-sucedida, é recomendado que os novos aplicativos .NET usem o Entity Framework Core. O Entity Framework proporciona uma forma mais natural de trabalhar com dados tabulares como modelos de objeto e conta com uma interface de programação mais simples.

Você pode criar controles associados a dados arrastando itens da janela Fontes de Dados para o designer do WPF ou do Windows Forms. Cada item na janela Fontes de Dados possui um controle padrão que é criado ao arrastá-lo para o designer. No entanto, você pode optar por criar um controle diferente.

Definir os controles a serem criados para objetos ou tabelas de dados

Antes de arrastar itens que representam objetos ou tabelas de dados da janela Fontes de Dados, você pode optar por exibir todos os dados em um controle ou exibir cada coluna ou propriedade em um controle separado.

Nesse contexto, o termo objeto refere-se a um objeto de negócios personalizado, uma entidade (em um Modelo de Dados de Entidade) ou um objeto retornado por um serviço.

Para definir os controles a serem criados para objetos ou tabelas de dados

  1. Verifique se o designer do WPF ou o designer do Windows Forms está aberto.

  2. Na janela Fontes de Dados, selecione o item que representa o objeto ou a tabela de dados que você deseja definir.

    Dica

    Se a janela Fontes de Dados não estiver aberta, você poderá abri-la selecionando Exibir>Outras Janelas>Fontes de Dados.

  3. Clique no menu da lista suspensa do item e selecione um dos seguintes itens no menu:

    • Para exibir cada campo de dados em um controle separado, clique em Detalhes. Quando você arrasta o item de dados para o designer, essa ação cria um controle associado a dados diferente para cada coluna ou propriedade do objeto ou tabela de dados pai, juntamente com rótulos para cada controle.

    • Para exibir todos os dados em um só controle, selecione um controle diferente na lista, como DataGrid ou List em um aplicativo WPF ou DataGridView em um aplicativo Windows Forms.

    A lista de controles disponíveis depende de qual designer você abriu, de qual versão do .NET o projeto tem como destino e de você ter adicionado controles personalizados com suporte para a associação de dados à Caixa de Ferramentas. Se o controle que você deseja criar não estiver na lista de controles disponíveis, você poderá adicioná-lo à lista. Para obter mais informações, confira Adicionar controles personalizados à janela Fontes de Dados.

    Para saber como criar um controle personalizado do Windows Forms que pode ser adicionado à lista de controles para objetos ou tabelas de dados na janela Fontes de Dados, consulte Criar um controle do usuário do Windows Forms com suporte para associação de dados complexa.

Definir os controles a serem criados para propriedades ou colunas de dados

Antes de arrastar um item que representa uma coluna ou uma propriedade de um objeto da janela Fontes de Dados para o designer, você pode definir o controle a ser criado.

Para definir os controles a serem criados para propriedades ou colunas

  1. Verifique se o designer do WPF ou o designer do Windows Forms está aberto.

  2. Na janela Fontes de Dados, expanda a tabela ou objeto desejado para exibir suas colunas ou propriedades.

  3. Selecione cada coluna ou propriedade para a qual deseja definir o controle a ser criado.

  4. Clique no menu da lista suspensa da coluna ou propriedade e selecione o controle que deseja criar quando o item for arrastado para o designer.

    A lista de controles disponíveis depende de qual designer você abriu, de qual versão do .NET o projeto tem como destino e de quais controles personalizados com suporte para associação de dados você adicionou à Caixa de Ferramentas. Se o controle que você deseja criar estiver na lista de controles disponíveis, você poderá adicioná-lo à lista. Para obter mais informações, confira Adicionar controles personalizados à janela Fontes de Dados.

    Para saber como criar um controle personalizado que pode ser adicionado à lista de controles para propriedades ou colunas de dados na janela Fontes de Dados, consulte Criar um controle do usuário do Windows Forms com suporte para associação de dados simples.

    Se não quiser criar um controle para a coluna ou propriedade, selecione Nenhum no menu da lista suspensa. Isso será útil se você quiser arrastar a tabela ou o objeto pai para o designer, mas não quiser incluir a coluna ou propriedade específica.