Acceso global a objetos en los proyectos de Office

Artículo
08/10/2011

Cuando se crea un proyecto de Office, Visual Studio genera automáticamente una clase denominada Globals en el proyecto. La clase Globals se puede utilizar para obtener acceso en tiempo de ejecución a diversos elementos del proyecto desde cualquier código del proyecto.

Se aplica a: la información de este tema se aplica a los proyectos de nivel de documento y los proyectos de nivel de aplicación para Microsoft Office 2010 y 2007 Microsoft Office System. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.

Cómo utilizar la clase Globals

Globals es una clase estática que mantiene referencias a determinados elementos del proyecto. Con la clase Globals, se puede obtener acceso en tiempo de ejecución a los siguientes elementos desde cualquier código del proyecto:

Las clases ThisWorkbook y Sheetn de un proyecto de libro o de plantilla de Excel. Puede tener acceso a estos objetos utilizando las propiedades Globals.ThisWorkbook y Sheetn.
La clase ThisDocument de un proyecto de documento o de plantilla de Word. Puede obtener acceso a este objeto mediante la propiedad Globals.ThisDocument.
La clase ThisAddIn de un proyecto de nivel de aplicación. Puede obtener acceso a este objeto mediante la propiedad 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 mediante la propiedad Globals.Ribbons. Para obtener más información, vea Obtener acceso a la cinta de opciones en tiempo de ejecución.
Todas las áreas de formulario de Outlook en un proyecto de complemento de Outlook. Puede obtener acceso a las áreas del formulario mediante la propiedad Globals.FormRegions. Para obtener más información, vea Obtener acceso a un área de formulario en tiempo de ejecución.
Un objeto de generador que permite crear controles, etiquetas inteligentes y elementos host de la Cinta en tiempo de ejecución en proyectos destinados a .NET Framework 4. Puede obtener acceso a este objeto mediante la propiedad Globals.Factory. Este objeto es una instancia de una clase que implementa una de las siguientes interfaces:
Nota

Las etiquetas inteligentes están desusadas en Excel 2010 y Word 2010. Para obtener más información, vea Información general sobre etiquetas inteligentes.

Nota

La propiedad Factory solo está disponible para proyectos destinados a .NET Framework 4. Los proyectos destinados a .NET Framework 3.5 usan otros métodos para crear controles, etiquetas inteligentes y elementos host de la Cinta en tiempo de ejecución.

Por ejemplo, se puede utilizar la propiedad Globals.Sheet1 para insertar texto en un control NamedRange de Sheet1 cuando el usuario hace clic en un botón del recuadro de acciones en un proyecto de nivel de documento para 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;
}

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 usa una propiedad de la clase Globals desde dentro de una clase de control de usuario, debe saber si la propiedad devuelve null antes de intentar utilizar el objeto devuelto.