Acesso global a objetos em projetos do Office

Artigo
02/25/2013

Quando você cria um projeto do Office, o Visual Studio gera automaticamente uma classe denominada Globals no projeto.Você pode usar a classe de Globals para acessar em tempo de execução vários itens diferentes de projeto de todo o código no projeto.

Aplicáve a: As informações neste tópico se aplicam a projetos em nível de aplicativo e em nível de documento para o Office 2013 e o Office 2010. Consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Como usar a classe Globals

Globals é um classe estática que mantém referências a determinados itens em seu projeto.Usando a classe de Globals , você pode acessar os seguintes itens de todo o código no projeto em tempo de execução:

As classes de ThisWorkbook e de Sheetem em um projeto de pasta de trabalho do Excel ou modelo.Você pode acessar esses objetos usando as propriedades de Globals.ThisWorkbook e de Sheetem .
A classe de ThisDocument em um projeto do documento do Word ou modelo.Você pode acessar esse objeto usando a propriedade de Globals.ThisDocument .
A classe de ThisAddIn em um projeto de aplicativo.Você pode acessar esse objeto usando a propriedade de Globals.ThisAddIn .
Todas as fitas em seu projeto que você personalizou utilizando o designer de fita.Você pode acessar as fitas usando a propriedade de Globals.Ribbons .Para obter mais informações, consulte Acessando a faixa de opções em tempo de execução.
Todas as regiões do formulário do Outlook em um suplemento do Outlook se o projeto.Você pode acessar as regiões do formulário usando a propriedade de Globals.FormRegions .Para obter mais informações, consulte Acessando uma região de formulário em tempo de execução.
Um objeto de fábrica que permite que você crie controles de fita, e itens de hosts em tempo de execução nos projetos que destinam-se .NET Framework 4 ou .NET Framework 4.5.Você pode acessar esse objeto usando a propriedade de Globals.Factory .Este objeto é uma instância de uma classe que implementa um as seguintes interfaces:

Por exemplo, você pode usar a propriedade de Globals.Sheet1 para inserir texto em um controle de NamedRange em Sheet1 quando um usuário clica em um botão no painel ações em um projeto da nível do excel.

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    Handles Button1.Click
    Globals.Sheet1.NamedRange1.Value2 = Me.TextBox1.Text
End Sub

private void button1_Click(object sender, EventArgs e)
{
    Globals.Sheet1.namedRange1.Value2 = this.textBox1.Text;
}

Inicializando a classe Globals

O código que tenta utilizar a classe de Globals antes do documento ou o suplemento sejam inicializados completamente pode acionar uma exceção de tempo de execução.Por exemplo, usando Globals quando declarar uma variável de nível de classe pode falhar devido a classe de Globals não pode ser inicializada com referências a todos os itens de host antes que o objeto declarado é instanciado.

Observação
A classe de Globals nunca é inicializada em tempo de design, mas as instâncias do controle são criadas pelo designer.Isso significa que se você criar um controle de usuário que usa uma propriedade da classe de Globals de dentro de uma classe de controle de usuário, você deve se a propriedade retorna null antes de tentar usar o objeto retornado.