O Visual Studio Tools for Office Projeto eventos

Artigo
08/25/2010

Cada modelo de projeto Ferramentas do Visual Studio para o Office gera automaticamente vários manipuladores de eventos.Os manipuladores de eventos para personalizações em nível de documento são ligeiramente diferentes de manipuladores de eventos para nível de aplicativo Adicionar-ins.

Para obter mais informações sobre personalizações e Adicionar-ins, consulte Visão geral de desenvolvimento de soluções do Office.

Personalizações de nível de documento

Ferramentas do Visual Studio para o Office fornece código gerado por trás de novos ou existentes documentos ou planilhas em personalizações em nível de documento.Este código lança dois eventos diferentes: Startup e Shutdown.

Eventos de inicialização

O evento Startup é gerado para cada um dos itens host (documento ou planilha) depois que o documento for Executando e Tudo o código no assembly inicialização tiver sido executado.É Último coisa para Executando no construtor da classe que seu código está sendo executado no.Para obter mais informações sobre os itens de host, consulte Itens de host e Visão geral sobre controles de host.

Quando você cria um projeto de nível de documento, o Ferramentas do Visual Studio para o Office cria manipuladores de eventos para o evento Startup nos arquivos de código gerado:

Para projetos do Microsoft Office Word, o manipulador de eventos é denominado ThisDocument_Startup.
Para projetos do Microsoft Office Excel, os manipuladores de evento tenham os nomes de seguintes:
- Sheet1_Startup
- Sheet2_Startup
- Sheet3_Startup
- ThisWorkbook_Startup

Eventos de desligamento

O evento Shutdown é gerado para cada um dos itens host (documento ou planilha) quando o domínio de aplicativo que seu código é carregado no é Sobre para descarregar.É Último coisa a ser chamado na classe como ele descarrega.

Quando você cria um projeto de nível de documento, o Ferramentas do Visual Studio para o Office cria manipuladores de eventos para o evento Shutdown nos arquivos de código gerado:

Para projetos do Microsoft Office Word, o manipulador de eventos é denominado ThisDocument_Shutdown.
Para projetos do Microsoft Office Excel, os manipuladores de evento tenham os nomes de seguintes:
- Sheet1_Shutdown
- Sheet2_Shutdown
- Sheet3_Shutdown
- ThisWorkbook_Shutdown

Observação:
Fazer não programaticamente Remover controles durante a Shutdown manipulador de eventos do documento.Os elementos de interface do usuário do documento não estão mais disponíveis quando ocorre o evento Shutdown.Se você quiser remover controles antes do aplicativo ser fechado, Adicionar seu código para outro manipulador de eventos, como BeforeClose ou BeforeSave.

Declaração de método de manipulador de eventos

Cada declaração de método do manipulador de evento contém os argumentos mesmos passados para ele: sender and e.Refere-Excel, o argumento sender se a planilha, como Sheet1 ou Sheet2; no Word, o argumento sender se refere ao documento.O argumento e refere-se aos argumentos padrão de um evento, que não são usados neste maiúscminúsc.

O exemplo de código seguinte mostra os manipuladores de eventos padrão nos projetos de nível de documento do Word.

Private Sub ThisDocument_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Startup

End Sub

Private Sub ThisDocument_Shutdown(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Shutdown

End Sub

private void ThisDocument_Startup(object sender, System.EventArgs e)
{
}

private void ThisDocument_Shutdown(object sender, System.EventArgs e)
{
}

O exemplo de código seguinte mostra os manipuladores de eventos padrão nos projetos de nível de documento para o Excel.

Observação:
O Após o código de exemplo mostra os manipuladores de eventos na Classe de Sheet1.Os nomes dos manipuladores de eventos em Outro classes de item de host correspondem ao Nome de Classe.Por exemplo, na classe Sheet2 , o manipulador de eventos Startup é chamado Sheet2_Startup.Na classe ThisWorkbook , o manipulador de eventos Startup é denominado ThisWorkbook_Startup.

Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Startup

End Sub

Private Sub Sheet1_Shutdown(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Shutdown

End Sub

private void Sheet1_Startup(object sender, System.EventArgs e)
{
}

private void Sheet1_Shutdown(object sender, System.EventArgs e)
{
}

Nível de aplicativo Adicionar-ins

Ferramentas do Visual Studio para o Office fornece código gerado em nível de aplicativo Adicionar-ins.Este código lança dois eventos diferentes: Startup e Shutdown.

Eventos de inicialização

O evento Startup é disparado após o Adicionar - in é carregado e Tudo o código no assembly inicialização tiver sido executado.Este evento é tratado pelo método ThisAddIn_Startup no arquivo de código gerado.

Código no manipulador de eventos ThisAddIn_Startup é o primeiro código de usuário para executar, a menos que seu Adicionar - in substitui o método RequestComAddInAutomationService.Nesse maiúscminúsc, o manipulador de eventos de ThisAddIn_Startup é chamado após RequestComAddInAutomationService.Em Adicionar-ins para o 2007 Microsoft Office Sistema, código no manipulador de eventos de ThisAddIn_Startup pode também ser chamado após o método de RequestService, se o suplemento substitui esse método.

Para obter mais informações sobre a seqüência de inicialização de Adicionar-ins, consulte Arquitetura de nível de aplicativo Adicionar-ins.

Eventos de desligamento

O evento Shutdown é disparado quando o domínio do aplicativo que seu código é carregado no é Sobre a ser descarregado.Este evento é tratado pelo método ThisAddIn_Shutdown no arquivo de código gerado.Este manipulador de eventos é o último Código do Usuário para ser executado quando o Adicionar - in é descarregado.