Demonstra Passo a passo: Criando seu primeira personalização em nível de documento do Excel

Artigo
08/08/2011

Este passo a passo introdutória mostra como criar uma personalização em nível de documento do Excel de Microsoft Office. Os recursos que você criar nesse tipo de solução estão disponíveis somente quando uma determinada pasta de trabalho é aberta. É possível usar uma personalização em nível de documento para fazer alterações em todo o aplicativo, por exemplo, exibindo uma nova guia na faixa de opções quando qualquer pasta de trabalho é aberta.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento 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 pasta de trabalho do Excel.
Adicionando texto a uma planilha que está hospedada no designer de Visual Studio.
Escrevendo código que usa o modelo de objeto do Excel para adicionar texto à planilha personalizada quando ele é aberto.
A criação e execução do projeto para testá-lo.
Limpando o projeto concluído para remover arquivos desnecessários de compilação e configurações de segurança do 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 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 projeto de pasta de trabalho do Excel 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 Pasta de trabalho do Excel 2007 ou Pasta de trabalho do Excel 2010.
No nome , digite FirstWorkbookCustomization.
Click OK.

O Visual Studio Tools for Office Project Wizard abre.
Selecione criar um novo documentoe clique em OK.
- Visual Studiocria o FirstWorkbookCustomization de projeto e adiciona os seguintes arquivos ao projeto.
- FirstWorkbookCustomization. xlsx - representa a pasta de trabalho do Excel no projeto. Contém todas as planilhas e gráficos.
- Sheet1 (arquivo. vb para Visual Basic ou o arquivo. cs para Visual C#) - uma planilha que fornece a superfície de design e o código para a primeira planilha na pasta de trabalho. For more information, see Item de Host de planilha.
- Plan2 (arquivo. vb para Visual Basic ou o arquivo. cs para Visual C#) - uma planilha que fornece a superfície de design e o código para a segunda planilha na pasta de trabalho.
- Sheet3 (arquivo. vb para Visual Basic ou o arquivo. cs para Visual C#) - uma planilha que fornece a superfície de design e o código para a terceira planilha na pasta de trabalho.
- ThisWorkbook (arquivo. vb para Visual Basic) ou o arquivo. cs para Visual C# - contém a superfície de design e o código para personalizações em nível de pasta de trabalho. For more information, see Item de Host da pasta de trabalho.
O arquivo de código de Sheet1 é aberto automaticamente no designer.

Fechar e reabrir a planilhas no Designer

Se você intencionalmente ou acidentalmente fechar uma pasta de trabalho ou uma planilha no designer enquanto você estiver desenvolvendo seu projeto, você poderá reabri-lo.

Feche e reabra a uma planilha no designer

Feche a pasta de trabalho clicando o Fechar o botão (X) para a janela de designer.
Em Solution Explorer, com o botão direito do Sheet1 arquivo de código e, em seguida, clique em View Designer.

- or -

Em Solution Explorer, clique duas vezes o Sheet1 o arquivo de código.

Adicionar texto a uma planilha no Designer

Você pode projetar a interface do usuário (UI) de sua personalização, modificando a planilha que está aberta no designer. Por exemplo, adicionar texto às células, fórmulas de aplicar ou adicionar controles do Excel. Para obter mais informações sobre como usar o designer, consulte Projetos do Office no ambiente de Visual Studio.

Para adicionar texto a uma planilha usando o designer

Selecione a célula na planilha que está aberta no designer, A1e digite o texto a seguir.

Este texto foi adicionado usando o designer.

Aviso

Se você adicionar essa linha de texto à célula A2, ele será substituído por outro código neste exemplo.

A adição de texto para uma planilha programaticamente

Em seguida, adicione o código para o arquivo de código de Sheet1. O novo código usa o modelo de objeto do Excel para adicionar uma segunda linha de texto para a pasta de trabalho. Por padrão, o arquivo de código de Sheet1 contém o seguinte código gerado:

Uma definição parcial da Sheet1 classe, que representa o modelo de programação da planilha e fornece acesso ao modelo de objeto do Excel. Para obter mais informações, Item de Host de planilha e Palavra Overview do modelo de objeto. O restante do Sheet1 classe é definida em um arquivo de código oculto que você não deve modificar.
O Sheet1_Startup e Sheet1_Shutdown manipuladores de evento. Esses manipuladores de eventos são chamados quando o Excel carrega e descarrega sua personalização. Use esses manipuladores de evento para inicializar sua personalização quando ele for carregado e limpar os recursos usados por sua personalização, quando ela é descarregada. For more information, see Eventos em projetos do Office.

Para adicionar uma segunda linha de texto para a planilha usando código

Em Solution Explorer, com o botão direito Sheet1e em seguida, clique em Exibir código.

O arquivo de código se abre no Visual Studio.

Substituir o Sheet1_Startup o manipulador de eventos com o código a seguir. Quando Sheet1 é aberto, este código adiciona uma segunda linha de texto para a planilha.

Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
    Dim nr As Microsoft.Office.Tools.Excel.NamedRange = _
        Me.Controls.AddNamedRange(Me.Range("A2"), "NamedRange1")
    nr.Value2 = "This text was added by using code"
End Sub

private void Sheet1_Startup(object sender, System.EventArgs e)
{
    Microsoft.Office.Tools.Excel.NamedRange nr =
        this.Controls.AddNamedRange(this.Range["A2", missing], "NamedRange1");
    nr.Value2 = "This text was added by using code";
}

Testing the Project

Para testar a sua pasta de trabalho.

Pressione F5 para criar e executar seu projeto.

Quando você constrói o projeto, o código é compilado em um assembly que está associado com a pasta de trabalho. Visual Studio coloca uma cópia da pasta de trabalho e o assembly na pasta de saída de compilação do projeto e ela configura as configurações de segurança no computador de desenvolvimento para permitir a personalização executar. For more information, see Visão Geral do Processo de Compilação de uma Solução Office.
Na pasta de trabalho, verifique se você ver o seguinte texto.

Este texto foi adicionado usando o designer.

Este texto foi adicionado por meio de código.
Feche a pasta de trabalho.

Limpando o projeto.

Quando terminar de desenvolver um projeto, você deve remover os arquivos na pasta de saída de compilação e as configurações de segurança criadas pelo processo de compilação.

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 uma personalização básica do nível de documento do Excel, você pode aprender mais sobre como desenvolver personalizações com estes tópicos:

Tarefas de programação gerais que você pode executar no nível do documento personalizações: Programação personalizações em nível de documento.
Tarefas de programação que são específicas para personalizações em nível de documento 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 do Excel, por exemplo, adicionando uma guia personalizada à Faixa de opções ou criar seu próprio painel de ações: Personalização de interface do usuário do Office.
Usando objetos do Excel estendidos fornecidos pelas ferramentas de desenvolvimento do Office em Visual Studio para executar tarefas que não são possíveis usando o modelo de objeto do Excel (por exemplo, a hospedagem de controles gerenciados em documentos e controles do Excel de ligação a dados usando o modelo de ligação de dados do Windows Forms): Automatizar o Excel usando o Extended objetos.
Criação e depuração de personalizações em nível de documento do Excel: Criação e depuração de soluções do Office.
Implantando as personalizações em nível de documento do Excel: Implantar soluções do Office.