Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Instruções passo a passo: criando a primeira personalização no nível do documento para Excel

 

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

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

Este passo a passo mostra as tarefas a seguir:

  • Criando um projeto de pasta de trabalho do Excel.

  • Adicionar texto a uma planilha que é hospedada no designer do Visual Studio.

  • Escrever um código que usa o modelo de objeto do Excel para adicionar texto à planilha personalizada quando ele é aberto.

  • Compilaçã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.

System_CAPS_noteObservaçã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, consulte 22c4debb-4e31-47a8-8f19-16f328d7dcd3.

Pré-requisitos

Você vai precisar dos seguintes componentes para realizar este passo a passo:

Para criar um novo projeto de pasta de trabalho do Excel no Visual Studio

  1. Inicie o Visual Studio.

  2. No menu File, aponte para New e clique em Project.

  3. No painel modelos, expandaVisual C#ouVisual Basice, em seguida, expandaOffice/SharePoint.

  4. Em expandidaOffice/SharePointnó, selecione osuplementos do Officenó.

  5. Na lista de modelos de projeto, escolha um projeto de suplemento VSTO do Excel.

  6. NonomedigiteFirstWorkbookCustomization.

  7. Clique em OK.

    OVisual Studio Tools for Office Project Wizardabre.

  8. Selecione Criar um novo documento, e clique OK.

    • Visual Studiocria oFirstWorkbookCustomizationde 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. Para obter mais informações, consulte Item de host de planilha.

    • Sheet2 (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 de personalizações em nível de pasta de trabalho. Para obter mais informações, consulte Item de host da pasta de trabalho.

    O arquivo de código Sheet1 é aberto automaticamente no designer.

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

Feche e reabra a uma planilha no designer

  1. Feche a pasta de trabalho clicando oFecharbotão (X) para a janela do designer.

  2. EmSolution Explorercom o botão direito doSheet1arquivo de código e, em seguida, clique emView Designer.

    -ou-

    EmSolution Explorerclique duas vezes oSheet1arquivo de código.

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

Para adicionar texto a uma planilha usando o designer

  1. Na planilha que está aberta no designer, selecione a célulaA1e, em seguida, digite o texto a seguir.

    Este texto foi adicionado usando o designer.

System_CAPS_warningAviso

Se você adicionar essa linha de texto para a célulaA2ele será substituído por outro código nesse exemplo.

Em seguida, adicione 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 na pasta de trabalho. Por padrão, o arquivo de código Sheet1 contém o seguinte código gerado:

  • Uma definição parcial daSheet1classe, 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 da planilhaeVisão geral do modelo de objeto do Word. O restante doSheet1classe é definida em um arquivo de código oculto que você não deve modificar.

  • OSheet1_StartupeSheet1_Shutdownmanipuladores de eventos. Esses manipuladores de eventos são chamados quando o Excel carrega e descarrega a personalização. Use esses manipuladores de eventos para inicializar sua personalização quando ele for carregado e para limpar os recursos usados pela sua personalização quando ela for descarregada. Para obter mais informações, consulte O Visual Studio Tools for Office Projeto eventos.

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

  1. EmSolution Explorerclique com botão direitoSheet1e, em seguida, clique emExibir código.

    O arquivo de código é aberto no Visual Studio.

  2. Substitua oSheet1_Startupmanipulador de eventos com o código a seguir. Quando Sheet1 é aberto, esse código adiciona uma segunda linha de texto na planilha.

    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";
    }
    

Para testar sua pasta de trabalho

  1. PressioneF5para compilar e executar seu projeto.

    Quando você compilar 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 o assembly na pasta de saída de compilação do projeto, e ele define as configurações de segurança no computador de desenvolvimento para permitir a personalização executar. Para obter mais informações, consulteCriando soluções do Office.

  2. Na pasta de trabalho, verifique se que você vê o seguinte texto.

    Este texto foi adicionado usando o designer.

    Este texto foi adicionado por meio de código.

  3. Feche a pasta de trabalho.

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 computador de desenvolvimento

  1. No Visual Studio, nocriarmenu, clique emLimpar solução.

Próximas etapas

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

Mostrar: