Global Acessar a objetos no Visual Studio Tools para projetos do Office

Artigo
08/25/2010

Você pode usar a classe Globals para acessar vários itens de projeto diferente de qualquer código no projeto.

Como usar globais

Globals é uma Estático classe que mantém referências a itens no seu projeto.Usando a classe de Globals, você pode Referência os seguintes itens de qualquer código no projeto:

O Workbook ou qualquer item de host de Worksheet em um projeto de modelo ou pasta de trabalho do Excel.Você acessar esses itens de host usando propriedades da classe Globals que fazem referência a cada item de host em seu projeto.Por padrão, os nomes de item de host são ThisWorkbook, Sheet1, Sheet2e Sheet3.
O host de Document item no Word projeto de documento ou modelo.O nome padrão para esta propriedade de item de host é Globals.ThisDocument.
O item de host AddIn em um projeto de nível de aplicativo.O nome padrão para esta propriedade de item de host é Globals.ThisAddIn.
Tudo as faixas de opções em seu projeto que você personalizados usando o Designer de Faixa de Opções.Você pode acessar as faixas de opções usando a propriedade Globals.Ribbons.
Tudo as regiões de formulário do Outlook em um Outlook Adicionar no projeto.Você pode acessar as regiões de formulário usando a propriedade Globals.FormRegions.

Por exemplo, você pode Gravar código para inserir texto em um Controlarar de NamedRangeSheet1 quando um usuário clica em um botão no painel de ações, como mostra o exemplo a seguir.

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    Handles Button1.Click

    If Globals.Sheet1 IsNot Nothing Then
        Globals.Sheet1.NamedRange1.Value2 = Me.TextBox1.Text
    End If

End Sub

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

Inicializando a classe de globais

O código que tenta usar a classe Globals antes do documento ou Adicionar - in está completamente inicializado pode lançar uma exceção de tempo de execução.Por exemplo, a usar Globals ao declarar uma variável de nível de classe pode falhar porque a classe Globals não pode ser inicializada com referências a Tudo itens de host antes do objeto declarado é instanciado.

Observação:
O Classe de Globals nunca é inicializado em tempo de design, mas instâncias de Controlarar são criadas pelo designer.Isso significa que, se você criar um Controlarar de usuário que chama os métodos da classe Globals , você deve Gravar código que verifica se o método retorna null antes de tentar Acessar-lo.