Partilhar via


Adicionar controles personalizados à janela Fontes de Dados para aplicativos do .NET Framework

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.

Ao arrastar um item da janela Fontes de Dados para uma superfície de design para criar um controle associado a dados, você pode selecionar o tipo de controle criado. Cada item na janela tem uma lista suspensa que exibe os controles que você pode escolher. O conjunto de controles associado a cada item é determinado pelo tipo de dados do item. Se o controle que você deseja criar não aparecer na lista, você poderá seguir as instruções neste tópico para adicionar o controle à lista.

Para obter mais informações sobre como selecionar controles associados a dados a serem criados para itens na janela Fontes de Dados, consulte Definir o controle a ser criado ao arrastar da janela Fontes de Dados.

Personalizar a lista de controles associáveis

Para adicionar ou remover controles da lista de controles disponíveis para itens na janela Fontes de Dados com um tipo de dados específico, execute as etapas a seguir.

Para selecionar os controles a serem listados para um tipo de dados

  1. Verifique se o Designer do WPF ou o Designer de Formulários do Windows está aberto.

  2. Na janela Fontes de Dados, clique em um item que faça parte de uma fonte de dados adicionada à janela e selecione o menu da lista suspensa do item.

    Dica

    Se a janela Fontes de Dados não estiver aberta, abra-a selecionando Exibir>Outras Janelas>Fontes de Dados.

  3. No menu suspenso, clique em Personalizar. Uma das seguintes caixas de diálogo é aberta:

  4. Na caixa de diálogo, selecione um tipo de dados na lista suspensa Tipo de dados.

    • Para personalizar a lista de controles de uma tabela ou objeto, selecione [Lista].

    • Para personalizar a lista de controles para uma coluna de uma tabela ou uma propriedade de um objeto, selecione o tipo de dados da coluna ou propriedade no armazenamento de dados subjacente.

    • Para personalizar a lista de controles para exibir objetos de dados com formas definidas pelo usuário, selecione [Outros]. Por exemplo, selecione [Outros] se o aplicativo tiver um controle personalizado que exibe dados de mais de uma propriedade de um objeto específico.

  5. Na caixa Controles associados, selecione cada controle que você deseja que esteja disponível para o tipo de dados selecionado ou desmarque a seleção de todos os controles que você deseja remover da lista.

    Observação

    Se o controle que você deseja selecionar não aparecer na caixa Controles associados, você deverá adicionar o controle à lista. Para obter mais informações, consulte Adicionar controles associados.

  6. Clique em OK.

  7. Na janela Fontes de Dados, clique em um item do tipo de dados que você acabou de associar a um ou mais controles e selecione o menu da lista suspensa do item.

    Os controles selecionados na caixa Controles associados agora aparecem no menu suspenso do item.

Adicionar controles associados

Se você quiser associar um controle a um tipo de dados, mas o controle não aparecer na caixa Controles associados, você deverá adicionar o controle à lista. O controle deve estar localizado na solução atual ou em um assembly referenciado. Ele também deve estar disponível na Caixa de Ferramentas e ter um atributo que especifique o comportamento de associação de dados do controle.

Para adicionar controles à lista de controles associados:

  1. Adicione o controle desejado à Caixa de Ferramentas clicando com o botão direito do mouse na Caixa de Ferramentas e selecionando Escolher Itens.

    O controle deve ter um dos seguintes atributos:

    Atributo Descrição
    DefaultBindingPropertyAttribute Implemente esse atributo em controles simples que exibem uma única coluna (ou propriedade) de dados, como um TextBox.
    ComplexBindingPropertiesAttribute Implemente esse atributo em controles que exibem listas (ou tabelas) de dados, como um DataGridView.
    LookupBindingPropertiesAttribute Implemente este atributo nos controles que exibem listas (ou tabelas) de dados, mas também precisam apresentar uma única coluna ou propriedade, como ComboBox.
  2. Para o Windows Forms, na caixa de diálogo Opções, abra a página Personalização da Interface do Usuário de Dados. Ou, para o WPF, abra a caixa de diálogo Personalizar Associação de Controle. Para obter mais informações, consulte Personalizar a lista de controles associáveis para um tipo de dados.

  3. Na caixa Controles associados, o controle que você acabou de adicionar à Caixa de Ferramentas deve aparecer.

    Observação

    Somente os controles localizados na solução atual ou em um assembly referenciado podem ser adicionados à lista de controles associados. (Os controles também devem implementar um dos atributos de associação de dados na tabela anterior.) Para associar dados a um controle personalizado que não está disponível na janela Fontes de Dados, arraste o controle da Caixa de Ferramentas para a superfície de design e arraste o item a ser associado da janela Fontes de Dados para o controle.