Acesso global a objetos em projetos do Office

Artigo
08/08/2011

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

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de nível de aplicativo para Microsoft Office 2010 e o sistema 2007 do Microsoft Office. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Como usar a classe de globais

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

O ThisWorkbook e Sheetn classes em um projeto de modelo ou a pasta de trabalho do Excel. Você pode acessar esses objetos usando o Globals.ThisWorkbook e Sheetn propriedades.
O ThisDocument da classe em uma palavra projeto de documento ou modelo. Você pode acessar esse objeto usando o Globals.ThisDocument propriedade.
O ThisAddIn a classe em um projeto de nível de aplicativo. Você pode acessar esse objeto usando o Globals.ThisAddIn propriedade.
Todas as faixas de opções em seu projeto personalizados usando o Designer de faixa de opções. Você pode acessar as faixas de opções usando o Globals.Ribbons propriedade. For more information, see Acessando a faixa de opções em tempo de execução.
Todas as regiões de formulário do Outlook em um projeto de suplemento do Outlook. Você pode acessar as regiões de formulário usando o Globals.FormRegions propriedade. For more information, see Acessar uma região de formulário em tempo de execução.

Um objeto de fábrica permite que você crie controles da faixa de opções, as marcas inteligentes e host itens em tempo de execução em projetos destinados a .NET Framework 4. Você pode acessar esse objeto usando o Globals.Factory propriedade. Este objeto é uma instância de uma classe que implementa uma as seguintes interfaces:

Observação
As marcas inteligentes estão obsoletas no Excel 2010 e Word 2010. For more information, see Visão geral sobre marcas inteligentes.

Observação
O Factory propriedade só está disponível para projetos que visam a .NET Framework 4. Projetos de destino do.NET Framework 3.5 usar outros métodos para criar os controles da faixa de opções, as marcas inteligentes e itens de host em tempo de execução.

Por exemplo, você pode usar o Globals.Sheet1 propriedade para inserir texto em um NamedRange controle em Sheet1 quando um usuário clica em um botão no painel de ações em um projeto de nível de documento para o 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 de globais

Código que tenta usar o Globals classe antes do documento ou suplemento está completamente inicializado pode lançar uma exceção de tempo de execução. Por exemplo, usando Globals quando declarar uma variável de nível de classe pode falhar porque o Globals classe poderá não ser inicializada com referências a todos os itens de host antes do objeto declarado é instanciado.

Observação
O Globals classe nunca é inicializado no tempo de design, mas instâncias de controle são criadas pelo designer. Isso significa que, se você criar um controle de usuário que utilize uma propriedade da Globals classe de dentro de uma classe de controle de usuário, você deve se a propriedade retornará null antes de tentar usar o objeto retornado.