Acceso global a objetos en proyectos de Visual Studio Tools para Office

Artículo
04/28/2010

Actualización: noviembre 2007

Puede utilizar la clase Globals para obtener acceso a varios elementos de proyecto diferentes desde cualquier código del proyecto.

Cómo utilizar Globals

Globals es una clase estática que mantiene referencias a los elementos del proyecto. Con la clase Globals, puede hacer referencia a los siguientes elementos desde cualquier código del proyecto:

Workbook o cualquier elemento host Worksheet en un proyecto de libro o de plantilla de Excel. El acceso a estos elementos host se realiza mediante las propiedades de la clase Globals que hacen referencia a cada elemento host del proyecto. De forma predeterminada, los nombres del elemento host son ThisWorkbook, Sheet1, Sheet2 y Sheet3.
El elemento host Document en un documento de Word o proyecto de plantilla. El nombre predeterminado de esta propiedad de elemento host es Globals.ThisDocument.
El elemento host AddIn en un proyecto de nivel de aplicación. El nombre predeterminado de esta propiedad de elemento host es Globals.ThisAddIn.
Todas las cintas de opciones del proyecto que haya personalizado mediante el Diseñador de la cinta de opciones. Puede obtener acceso a las cintas de opciones mediante la propiedad Globals.Ribbons.
Todas las áreas de formulario de Outlook en un proyecto de complemento de Outlook. Puede obtener acceso a las áreas de formulario mediante la propiedad Globals.FormRegions.

Por ejemplo, puede escribir código para insertar texto en un control NamedRange de Sheet1 cuando un usuario hace clic en un botón en el panel de acciones, como se muestra en el ejemplo siguiente.

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

Inicializar la clase Globals

El código que intenta utilizar la clase Globals antes de que el documento o el complemento se hayan inicializado por completo podría iniciar una excepción en tiempo de ejecución. Por ejemplo, al utilizar Globals cuando se declara una variable de nivel de clase podría fallar porque la clase Globals puede no haberse inicializado con referencias a todos los elementos host antes de que se cree una instancia del objeto declarado.

Nota:
La clase Globals nunca se inicializa en tiempo de diseño, pero el diseñador crea las instancias del control. Esto significa que si crea un control de usuario que llama a los métodos de la clase Globals, debe escribir código que compruebe si el método devuelve null antes de intentar tener acceso a él.