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

Artigo
02/25/2013

Essa explicação passo a passo de introdução mostra como criar um suplemento ao nível para o Microsoft Office Excel.Os recursos que você criou em este tipo de solução estão disponíveis para o próprio aplicativo, independentemente de que as 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 2013 e Excel 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Essa explicação passo a passo mostra as seguintes tarefas:

Criando um projeto do excel suplemento para o excel.
Escrevendo código que usa o modelo de objeto do excel para adicionar texto a uma pasta de trabalho quando é salvo.
Compilação e execução do projeto testá-lo.
Limpando o projeto terminado de modo que o suplemento não executa automaticamente no seu 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 de Visual Studio.

Pré-requisitos

Para completar este passo-a-passo, são necessários os seguintes componentes:

Uma edição do Visual Studio 2012 que inclui o Microsoft Office Developer Tools. Para obter mais informações, consulte [Configurando um computador para desenvolver soluções do Office](bb398242\(v=vs.110\).md).

Excel 2013 ou Excel 2010.

Criando o projeto

Para criar um novo projeto do suplemento do excel no Visual Studio

Inicie o Visual Studio
No menu File, aponte para New, e em seguida, clique em Project.
Em o painel de modelos, expanda Visual C# ou Visual Basicem seguida, expanda Office/SharePoint.
Sob o nó expandido de Office/SharePoint , selecione o nó de Suplementos do Office .
Em a lista de modelos de projeto, de suplemento do Excel 2010 selecione ou de Suplemento do Excel 2013.
Em a caixa de Nome , digite FirstExcelAddIn.
Clique em OK.

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

Escrevendo código para adicionar texto na pasta de trabalho salvo

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

Uma definição de classe parcial de ThisAddIn .Essa classe fornece uma ponto de entrada para seu código e fornece acesso ao modelo de objeto do excel.Para obter mais informações, consulte Os suplementos de nível de aplicativo de programação..O restante da classe de ThisAddIn é definido em um arquivo oculto de código que você não deve alterar.
os manipuladores de eventos de ThisAddIn_Startup e de ThisAddIn_Shutdown .Esses manipuladores de eventos são chamados quando o excel carregar e descarrega o suplemento.Use esses manipuladores de eventos para inicializar o suplemento quando ele for carregado, e para limpar os recursos usados pelo suplemento quando é descarregado.Para obter mais informações, consulte Eventos em projetos do Office.

Para adicionar uma linha de texto para a pasta de trabalho salvo

Em o arquivo de código de ThisAddIn, adicione o seguinte código à classe de ThisAddIn .O novo código define um manipulador de eventos para o evento de WorkbookBeforeSave , que é gerado quando uma pasta de trabalho são salvas.

Quando o usuário salva uma pasta de trabalho, o manipulador de eventos adicionar o novo texto no início da planilha ativo.

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");
    firstRow.EntireRow.Insert(Excel.XlInsertShiftDirection.xlShiftDown);
    Excel.Range newFirstRow = activeWorksheet.get_Range("A1");
    newFirstRow.Value2 = "This text was added by using code";
}

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

Para alterar a pasta de trabalho quando é salvo, o uso dos exemplos de código anterior os seguintes objetos:

O campo de Application da classe de ThisAddIn .O campo de Application retorna um objeto de Microsoft.Office.Interop.Excel.Application , que representa a instância atual do excel.
O parâmetro de Wb do manipulador de eventos para o evento de WorkbookBeforeSave .O parâmetro de Wb é um objeto de Microsoft.Office.Interop.Excel.Workbook , que representa a pasta de trabalho salvo.Para obter mais informações, consulte Visão geral sobre o modelo de objeto do Excel.

Testar o projeto.

para testar o projeto

Pressione F5 para compilar e executar o projeto.

Quando você criar o projeto, o código é compilado em um assembly que é incluído na pasta de saída de compilação para o projeto.O Visual Studio também cria um conjunto de entradas do Registro que permitem Excel para descobrir e carregar o suplemento, e configurar as configurações de segurança no computador de desenvolvimento para ativar o suplemento a execução.Para obter mais informações, consulte Construindo soluções do Office.
O excel, salve a pasta de trabalho.
Verifique se o texto a seguir é adicionado para a pasta de trabalho.

Esse texto foi adicionado usando código.
Feche o excel.

limpando o projeto

Quando você terminar de desenvolver um projeto, remova o assembly, as entradas de Registro, e as configurações de segurança do suplemento do seu computador de desenvolvimento.Caso contrário, o suplemento continuará a ser executado sempre que você abrir o excel no seu computador de desenvolvimento.

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

Em o Visual Studio, no menu de Compilar , clique Limpar solução.

Próximas etapas

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

Tarefas básicas de programação que você pode executar de suplementos: Os suplementos de nível de aplicativo de programação..
Tarefas de programação que são específicas a suplementos do excel: Soluções do Excel.
Usando o modelo de objeto do excel: Visão geral sobre o modelo de objeto do Excel.
Personalizando a interface de usuário (UI) do excel, por exemplo, adicionando um guia personalizado à fita ou criando seu próprio painel de tarefa personalizada: Personalização de interface do usuário do Office.
Suplementos em nível de compilação e de depuração do excel: Construindo soluções do Office.
Implantando suplementos do nível para o excel: Implantando uma solução do Office.