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

Artigo
02/25/2013

Essa explicação passo a passo mostra como criar uma introdução personalização da nível do Microsoft Office Excel.Os recursos que você criou em este tipo de solução estão disponíveis somente quando uma pasta de trabalho específica está aberta.Você não pode usar uma personalização da nível para fazer as alterações de todo, por exemplo, exibindo uma nova aba de fita 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 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 de pasta de trabalho do Excel.
Adicionando texto em uma planilha que está hospedada no designer do Visual Studio.
Escrevendo código que usa o modelo de objeto do excel para adicionar texto à planilha personalizado quando o é aberto.
Compilação e execução do projeto testá-lo.
Limpando o projeto concluído remover os arquivos e as configurações de segurança desnecessários de compilação 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 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 uma nova pasta de trabalho do Excel projeto 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 Pasta de Trabalho do Excel 2010 selecione ou de Pasta de Trabalho do Excel 2013.
Em a caixa de Nome , digite FirstWorkbookCustomization.
Clique em OK.

Visual Studio Tools para Office Project Wizard Abre.
Criar um novo documentoSelecione, e clique OK.
- Visual Studio criar o projeto de FirstWorkbookCustomization , e adicione os seguintes arquivos para o projeto.
- FirstWorkbookCustomization.xlsx - representa a pasta de trabalho do Excel no projeto.Contém todas as planilhas e elementos gráficos.
- Sheet1 (arquivo .vb para Visual Basic ou 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.Para obter mais informações, consulte Item de Host de planilha.
- Sheet2 (arquivo .vb para Visual Basic ou 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 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 arquivo cs para visual C#) - contém a superfície de design e o código para personalizações da pasta de apenas nível.Para obter mais informações, consulte Item de Host da pasta de trabalho.
O arquivo de código Sheet1 automaticamente é aberto no designer.

Fechando e reabrindo planilhas no designer

Se você fechar deliberadamente ou acidentalmente uma pasta de trabalho ou uma planilha no designer quando você desenvolver seu projeto, você poderá reabri-lo.

Para fechar e reabrir uma planilha no designer

Feche a pasta de trabalho clicando no botão de Fechar (X) para a janela de designer.
Em Gerenciador de Soluções, clique com o botão direito do mouse no arquivo de código de Plan1 , e clique Exibir Designer.

- ou -

Em Gerenciador de Soluções, clique duas vezes no arquivo de código de Plan1 .

Adicionando texto a uma planilha no designer

Você pode criar a interface de usuário (UI) de sua personalização alterando a planilha que é aberto no designer.Por exemplo, você pode adicionar o texto para as células, aplique fórmulas, 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

Em a planilha que é aberto no designer, selecione a célula A1, e digite o seguinte texto.

Esse texto foi adicionado usando o designer.

Cuidado
Se você adicionar esta linha de texto para a célula A2, será substituída por outro código em este exemplo.

Adicionando texto a uma planilha programaticamente

Em seguida, adicione o código ao arquivo de código 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 contém Sheet1 o seguinte código gerado:

Uma definição de classe parcial de Sheet1 , que representa o modelo de programação a planilha e fornece acesso ao modelo de objeto do excel.Para obter mais informações, Item de Host de planilha e Visão geral do modelo de objeto do Word.O restante da classe de Sheet1 é definido em um arquivo oculto de código que você não deve alterar.
os manipuladores de eventos de Sheet1_Startup e de Sheet1_Shutdown .Esses manipuladores de eventos são chamados quando o excel carregar e descarrega sua personalização.Use esses manipuladores de eventos para inicializar sua personalização quando ele for carregado, e para limpar os recursos usados por sua personalização quando é descarregado.Para obter mais informações, consulte Eventos em projetos do Office.

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

Em Gerenciador de Soluções, clique com o botão direito do mouse Plan1, clique em Exibir Código.

O arquivo de código abre no Visual Studio.

Substitua o manipulador de eventos de Sheet1_Startup com o código a seguir.Quando Sheet1 é aberto, este código adiciona uma segunda linha de texto à 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"], "NamedRange1");
    nr.Value2 = "This text was added by using code";
}

Testar o projeto.

para testar sua pasta de trabalho

Pressione F5 para compilar e executar o projeto.

Quando você criar o projeto, o código é compilado em um assembly que está associado com a pasta de trabalho.O Visual Studio coloca uma cópia da pasta de trabalho e assembly na pasta de saída de compilação para o projeto, e configurar as configurações de segurança no computador de desenvolvimento para permitir personalização para executar.Para obter mais informações, consulte Construindo soluções do Office.
Em a pasta de trabalho, verifique que você possa ver o texto a seguir.

Esse texto foi adicionado usando o designer.

Esse texto foi adicionado usando código.
Feche a pasta de trabalho.

limpando o projeto

Quando você 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 no seu computador de desenvolvimento

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

Próximas etapas

Agora que você criou uma personalização básica de um documento nível para o excel, você pode aprender mais sobre como desenvolver personalizações de esses tópicos:

Tarefas básicas de programação que você pode executar personalizações em nível da: Programação personalizações em nível de documento.
Tarefas de programação que são específicas a personalizações de nível para o excel: Soluções do Excel.
Usando o modelo de objeto do excel: Visão geral sobre o modelo de objeto do Excel.
Personalizando interface de usuário do excel, por exemplo, adicionando um guia personalizado à fita ou criando seu próprio painel de ações: Personalização de interface do usuário do Office.
Usando objetos estendidos Excel fornecidos por ferramentas de desenvolvimento do Office no Visual Studio para executar tarefas que não são possíveis usando o modelo de objeto do excel (por exemplo, hospedando controles gerenciados em documentos do excel e associar controles a dados usando o modelo de associação de dados dos formulários do windows): Automatizar o Excel usando o Extended objetos.
Personalizações da nível de compilação e de depuração do excel: Construindo soluções do Office.
Implantando personalizações da nível do excel: Implantando uma solução do Office.