Demonstra Passo a passo: Criando o primeiro nível do aplicativo Add-in para o Excel

Artigo
08/08/2011

Este passo a passo introdutória mostra como criar um suplemento em nível de aplicativo para o Excel de Microsoft Office. Os recursos que você criar nesse tipo de solução estão disponíveis para o aplicativo propriamente dito, independentemente de quais pastas de trabalho estão abertas.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de aplicativo para Excel 2007 e Excel 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

This walkthrough illustrates the following tasks:

Criando um projeto de suplemento do Excel para o Excel.
Escrevendo código que usa o modelo de objeto do Excel para adicionar texto a uma pasta de trabalho, quando ele for salvo.
A criação e execução do projeto para testá-lo.
Limpando o projeto concluído para que o suplemento não executa mais automaticamente no computador de desenvolvimento.

Observação
Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da 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, consulte Configurações do Visual Studio.

Pré-requisitos

You need the following components to complete this walkthrough:

Uma edição do Visual Studio 2010 que inclua as ferramentas de desenvolvedor do Microsoft Office. Para obter mais informações, consulte [Configurando um computador para desenvolver soluções do Office](bb398242\(v=vs.100\).md).

Microsoft Office Excel 2007 ou Excel 2010.

Creating the Project

Para criar um novo Excel add-in do projeto em Visual Studio

Start Visual Studio.
On the File menu, point to New, and then click Project.
No painel templates, expanda Visual C# ou Visual Basice em seguida, expanda Office.
Em expandida Office nó, selecione o 2007 se você tiver o Excel 2007 instalado, ou selecione o 2010 o nó se você tiver Excel 2010 instalado.
Na lista de modelos de projeto, selecione suplemento do Excel 2007 ou Excel Add-in 2010.
No nome , digite FirstExcelAddIn.
Click OK.

Visual Studiocria o FirstExcelAddIn de projeto e abre o arquivo de código ThisAddIn no editor.

Escrever código para adicionar texto a pasta de trabalho salva

Em seguida, adicione o código para o arquivo de código ThisAddIn. O novo código usa o modelo de objeto do Excel para inserir o timbre na primeira linha da planilha ativa. A planilha ativa é a planilha que está aberta quando o usuário salva a pasta de trabalho. Por padrão, o arquivo de código ThisAddIn contém o seguinte código gerado:

Uma definição parcial da ThisAddIn classe. Essa classe fornece um ponto de entrada para o seu código e fornece acesso ao modelo de objeto do Excel. For more information, see Os suplementos de nível de aplicativo de programação.. O restante do ThisAddIn classe é definida em um arquivo de código oculto que você não deve modificar.
O ThisAddIn_Startup e ThisAddIn_Shutdown manipuladores de evento. Esses manipuladores de eventos são chamados quando o Excel carrega e descarrega o suplemento. Use esses manipuladores de evento para inicializar seu suplemento quando ele for carregado e limpar os recursos usados por seu suplemento, quando ela é descarregada. For more information, see Eventos em projetos do Office.

Para adicionar uma linha de texto salvo na pasta de trabalho

No arquivo de código ThisAddIn, adicione o seguinte código para o ThisAddIn classe. O novo código define um manipulador de eventos para o WorkbookBeforeSave o evento, que é disparado quando uma pasta de trabalho é salvo.

Quando o usuário salva uma pasta de trabalho, o manipulador de evento adiciona novo texto no início da planilha ativa.

Private Sub Application_WorkbookBeforeSave(ByVal Wb As Microsoft.Office.Interop.Excel.Workbook, ByVal SaveAsUI As Boolean, ByRef Cancel As Boolean) Handles Application.WorkbookBeforeSave
    Dim activeWorksheet As Excel.Worksheet = CType(Application.ActiveSheet, Excel.Worksheet)
    Dim firstRow As Excel.Range = activeWorksheet.Range("A1")
    firstRow.EntireRow.Insert(Excel.XlInsertShiftDirection.xlShiftDown)
    Dim newFirstRow As Excel.Range = activeWorksheet.Range("A1")
    newFirstRow.Value2 = "This text was added by using code"
End Sub

void Application_WorkbookBeforeSave(Microsoft.Office.Interop.Excel.Workbook Wb, bool SaveAsUI, ref bool Cancel)
{
    Excel.Worksheet activeWorksheet = ((Excel.Worksheet)Application.ActiveSheet);
    Excel.Range firstRow = activeWorksheet.get_Range("A1", missing);
    firstRow.EntireRow.Insert(Excel.XlInsertShiftDirection.xlShiftDown, System.Type.Missing);
    Excel.Range newFirstRow = activeWorksheet.get_Range("A1", missing);
    newFirstRow.Value2 = "This text was added by using code";
}

Se você estiver usando o C#, adicione o seguinte código necessário para a ThisAddIn_Startup manipulador de eventos. Esse código é usado para conectar-se a Application_WorkbookBeforeSave o manipulador de eventos com o WorkbookBeforeSave de evento.
```
this.Application.WorkbookBeforeSave += new Microsoft.Office.Interop.Excel.AppEvents_WorkbookBeforeSaveEventHandler(Application_WorkbookBeforeSave);
```

Para modificar a pasta de trabalho quando ele for salvo, os exemplos de código anterior usam os seguintes objetos:

O Application campo de ThisAddIn classe. O Application campo retorna um Microsoft.Office.Interop.Excel.Application o objeto, que representa a instância atual do Excel.
O Wb parâmetro do manipulador de eventos para o WorkbookBeforeSave de evento. O Wb parâmetro é um Microsoft.Office.Interop.Excel.Workbook o objeto, que representa a pasta de trabalho salvas. For more information, see Visão geral do modelo de objeto do Excel.

Testing the Project

Para testar o projeto.

Pressione F5 para criar e executar seu projeto.

Quando você constrói o projeto, o código é compilado em um assembly que está incluído na pasta de saída de compilação do projeto. Visual Studio também cria um conjunto de entradas de registro que permitem que o Excel descobrir e carregar o suplemento, e ele define as configurações de segurança no computador de desenvolvimento para ativar o add-in executar. For more information, see Visão Geral do Processo de Compilação de uma Solução Office.
No Excel, salve a pasta de trabalho.
Verifique se o seguinte texto é adicionado à pasta de trabalho.

Este texto foi adicionado por meio de código.
Feche o Excel.

Limpando o projeto.

Quando terminar de desenvolver um projeto, remova o assembly do suplemento, entradas do registro e as configurações de segurança do seu computador de desenvolvimento. Caso contrário, o add-in continuará a ser executado toda vez que abrir o Excel no computador de desenvolvimento.

Para limpar o projeto concluído em seu computador de desenvolvimento

Em Visual Studio, sobre o Build menu, clique em Limpar solução.

Próximas etapas

Agora que você criou um suplemento do nível de aplicativo básico para o Excel, você pode aprender mais sobre como desenvolver suplementos com estes tópicos:

Tarefas de programação gerais que você pode executar no add-ins: Os suplementos de nível de aplicativo de programação..
Programação de tarefas que são específicas aos suplementos do Excel: Soluções do Excel.
Usando o modelo de objeto do Excel: Visão geral do modelo de objeto do Excel.
Personalizar a interface do usuário (UI) do Excel, por exemplo, adicionando uma guia personalizada à Faixa de opções ou criando seu próprio painel de tarefas personalizado: Personalização de interface do usuário do Office.
Criação e depuração de suplementos em nível de aplicativo para o Excel: Criação e depuração de soluções do Office.
Implantando os suplementos de nível de aplicativo para o Excel: Implantar soluções do Office.