Compartilhar via


Demonstra Passo a passo: Vincular dados a controles em um painel de ações do Excel

Este passo a passo demonstra a vinculação de dados a controles em um painel de ações no Microsoft Office Excel. Os controles demonstram uma relação mestre/detalhe entre tabelas em um banco de dados do SQL Server.

Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento para Excel. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

Este passo a passo ilustra as seguintes tarefas:

  • Adicionando controles a uma planilha.

  • Criando um controle de painel de ações.

  • Adicionando controles do Windows Forms vinculados a dados a um controle do painel de ações.

  • Mostrando o painel de ações quando o aplicativo é aberto.

Observação

Seu computador pode mostrar diferentes nomes ou locais para alguns dos elementos de interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, confira Personalizar o IDE do Visual Studio.

Pré-requisitos

Você precisará dos seguintes componentes para concluir este passo a passo:

  • Uma edição do Visual Studio que inclui o Microsoft Office Developer Tools. Para obter mais informações, consulte Configurar um computador para desenvolver soluções do Office.

  • Excel 2013 ou Excel 2010 .

  • Acesso a um servidor com o banco de dados de exemplo Northwind SQL Server.

  • Permissões para ler e gravar no banco de dados do SQL Server.

Criar o projeto

A primeira etapa é criar um projeto de pasta de trabalho do Excel.

Criar um novo projeto

  1. Crie um projeto de pasta de trabalho do Excel com o nome Meu Painel de Ações do Excel. No assistente, selecione Criar um novo documento. Para obter mais informações, consulte Como: Criar projetos do Office no Visual Studio.

    O Visual Studio abre a nova pasta de trabalho do Excel no designer e adiciona o projeto My Excel Actions Pane ao Gerenciador de Soluções.

Adicionar uma nova fonte de dados ao projeto

Para adicionar uma nova fonte de dados ao projeto

  1. Se a janela Fontes de Dados não estiver visível, exiba-a por, na barra de menus, escolhendo Exibir>Outras Fontes de Dados do Windows.>

  2. Escolha Adicionar Nova Fonte de Dados para iniciar o Assistente de Configuração de Fonte de Dados.

  3. Selecione Banco de Dados e clique em Avançar.

  4. Selecione uma conexão de dados com o banco de dados SQL Server de exemplo Northwind ou adicione uma nova conexão usando o botão Nova Conexão .

  5. Clique em Avançar.

  6. Desmarque a opção para salvar a conexão se ela estiver selecionada e clique em Avançar.

  7. Expanda o nó Tabelas na janela Objetos de banco de dados.

  8. Marque a caixa de seleção ao lado da tabela Fornecedores .

  9. Expanda a tabela Produtos e selecione ProductName, SupplierID, QuantityPerUnit e UnitPrice.

  10. Clique em Concluir.

    O assistente adiciona a tabela Fornecedores e a tabela Produtos à janela Fontes de Dados. Ele também adiciona um conjunto de dados tipado ao seu projeto que é visível no Gerenciador de Soluções.

Adicionar controles à planilha

Em seguida, adicione um controle e um NamedRange ListObject controle à primeira planilha.

Para adicionar um controle NamedRange e um controle ListObject

  1. Verifique se a pasta de trabalho My Excel Actions Pane.xlsx está aberta no designer do Visual Studio, com Sheet1 exibido.

  2. Na janela Fontes de Dados, expanda a tabela Fornecedores.

  3. Clique na seta suspensa no nó Nome da Empresa e clique em NamedRange.

  4. Arraste Nome da Empresa da janela Fontes de Dados para a célula A2 em Sheet1.

    Um NamedRange controle chamado CompanyNameNamedRange é criado e o texto <CompanyName> aparece na célula A2. Ao mesmo tempo, um nomeado suppliersBindingSource, um adaptador de tabela e um BindingSource DataSet são adicionados ao projeto. O controle está vinculado ao , que, por sua vez, BindingSourceestá vinculado à DataSet instância.

  5. Na janela Fontes de Dados, role para baixo após as colunas que estão abaixo da tabela Fornecedores. Na parte inferior da lista está a tabela Produtos , que está aqui porque é filha da tabela Fornecedores . Selecione esta tabela Produtos , não aquela que está no mesmo nível da tabela Fornecedores e, em seguida, clique na seta suspensa exibida.

  6. Clique em ListObject na lista suspensa e arraste a tabela Produtos para a célula A6 no Sheet1.

    Um ListObject controle chamado ProductNameListObject é criado na célula A6. Ao mesmo tempo, um adaptador nomeado productsBindingSource e um BindingSource adaptador de tabela são adicionados ao projeto. O controle está vinculado ao , que, por sua vez, BindingSourceestá vinculado à DataSet instância.

  7. Somente para C#, selecione suppliersBindingSource na bandeja do componente e altere a propriedade Modifiers para Internal na janela Properties.

Adicionar controles ao painel de ações

Em seguida, você precisa de um controle de painel de ações que tenha uma caixa de combinação.

Para adicionar um controle de painel de ações

  1. Selecione o projeto do Painel Minhas Ações do Excel no Gerenciador de Soluções.

  2. No menu Projeto , clique em Adicionar Novo Item.

  3. Na caixa de diálogo Adicionar Novo Item, selecione Controle do Painel de Ações, nomeie-o como ActionsControl e clique em Adicionar.

Para adicionar controles do Windows Forms vinculados a dados a um controle do painel de ações

  1. Nas guias Controles Comuns da Caixa de Ferramentas, arraste um ComboBox controle para o controle do painel de ações.

  2. Altere a propriedade Size para 171, 21.

  3. Redimensione o controle de usuário para caber na caixa de combinação.

Vincular o controle no painel de ações aos dados

Nesta seção, você definirá a fonte de dados do para a mesma fonte de ComboBox dados que o NamedRange controle na planilha.

Para definir propriedades de vinculação de dados do controle

  1. Clique com o botão direito do mouse no controle do painel de ações e clique em Exibir Código.

  2. Adicione o código a seguir ao Load evento do controle do painel de ações.

    private void ActionsControl_Load(object sender, EventArgs e)
    {
        this.comboBox1.DataSource = Globals.Sheet1.suppliersBindingSource;
        this.comboBox1.DisplayMember = "CompanyName";
    }
    
  3. No C#, você deve criar um manipulador de eventos para o ActionsControl. Você pode colocar esse código no ActionsControl construtor. Para obter mais informações sobre como criar manipuladores de eventos, consulte Como: Criar manipuladores de eventos em projetos do Office.

    public ActionsControl()
    {
        InitializeComponent();
        this.Load += new EventHandler(ActionsControl_Load);
    }
    

Mostrar o painel de ações

O painel de ações não fica visível até que você adicione o controle em tempo de execução.

Para mostrar o painel de ações

  1. No Gerenciador de Soluções, clique com o botão direito do mouse em ThisWorkbook.vb ou ThisWorkbook.cs e clique em Exibir Código.

  2. Crie uma nova instância do controle de usuário na ThisWorkbook classe.

    ActionsControl actions = new ActionsControl();
    
  3. Startup No manipulador de eventos de , adicione o controle ao painel de ThisWorkbookações.

    private void ThisWorkbook_Startup(object sender, System.EventArgs e)
    {
        this.ActionsPane.Controls.Add(actions);
    }
    

Testar o aplicativo

Agora você pode testar o documento para verificar se o painel de ações é aberto quando o documento é aberto e se os controles têm uma relação mestre/detalhe.

Para testar o documento

  1. Pressione F5 para executar o projeto.

  2. Confirme se o painel de ações está visível.

  3. Selecione uma empresa na caixa de listagem. Verifique se o nome da empresa está listado NamedRange no controle e se os detalhes do produto estão listados no ListObject controle.

  4. Selecione várias empresas para verificar se o nome da empresa e os detalhes do produto mudam conforme apropriado.

Próximas etapas

Estas são algumas tarefas que podem vir a seguir: