Globalny dostęp do obiektów w projektach pakietu Office
Podczas tworzenia projektu programu pakietu Office, Visual Studio automatycznie generuje klasę o nazwie Globals w projekcie.Można użyć Globals klasy dostęp do kilku różnych projektu elementów w czasie wykonywania z dowolnego kodu w projekcie.
Zastosowanie: Informacje przedstawione w tym temacie mają zastosowanie do projektów na poziomie dokumentu i aplikacji obsługiwanych w pakietach Office 2013 i Office 2010. Zobacz Funkcje dostępne w aplikacjach pakietu Office i typ projektu.
Jak używać klasy Globals
Globalsjest klasy statycznej, która utrzymuje odwołania do niektórych elementów w projekcie.Za pomocą Globals klasy, są dostępne następujące elementy z dowolnego kodu w projekcie w czasie wykonywania:
ThisWorkbook i Sheetn klasy w projekcie szablonu lub skoroszytu programu Excel.Obiekty te można uzyskać dostęp za pomocą Globals.ThisWorkbook i Sheetn właściwości.
ThisDocument Klasy w projekcie dokumentu lub szablonu programu Word.Dostęp do obiektu za pomocą Globals.ThisDocument właściwość.
ThisAddIn Klasy w projekcie na poziomie aplikacji.Dostęp do obiektu za pomocą Globals.ThisAddIn właściwość.
Wszystkie taśmy w projekcie, dostosowaną przez użytkownika przy użyciu projektanta wstążki.Wstążki można uzyskać dostęp za pomocą Globals.Ribbons właściwość.Aby uzyskać więcej informacji, zobacz Uzyskiwanie dostępu do wstążki w czasie wykonywania.
Wszystkie regiony formularzy programu Outlook w projekcie dodatek programu Outlook.Regiony formularzy można uzyskać dostęp za pomocą Globals.FormRegions właściwość.Aby uzyskać więcej informacji, zobacz Uzyskiwanie dostępu do regionów formularzy w czasie wykonywania.
Obiekt fabryki, można tworzyć formanty wstążki oraz udostępniać elementy w czasie wykonywania w projektach działania z programem Program .NET Framework 4 lub Program .NET Framework 4.5.Dostęp do obiektu za pomocą Globals.Factory właściwość.Ten obiekt jest instancją klasy implementującej jedną następujących interfejsów:
Na przykład, można użyć Globals.Sheet1 właściwość, aby wstawić tekst w NamedRange kontroli na Sheet1 kiedy użytkownik kliknie przycisk na stronie Actions w projekcie na poziomie dokumentu dla programu 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;
}
Inicjowanie klasy Globals
Kod, który odwołuje się do Globals klasę przed dokumentu lub dodatku jest całkowicie zainicjowany może zgłosić wyjątek czasu wykonywania.Na przykład, za pomocą Globals kiedy zadeklarowanie zmiennej poziomie klasy może zawieść, ponieważ Globals klasy może nie być zainicjowana z odniesieniem do wszystkich elementów hosta przed deklarowanym celem jest utworzone.
[!UWAGA]
Globals Klasy nigdy nie jest inicjowany w czasie projektowania, ale są tworzone wystąpienia formantu przez projektanta.Oznacza to, że jeśli tworzysz formant użytkownika, który używa właściwości z Globals klasy od wewnątrz klasy formantu użytkownika, użytkownik musi czy właściwość ta zwraca null zanim spróbujesz użyć zwracany obiekt.
Zobacz też
Koncepcje
Uzyskiwanie dostępu do wstążki w czasie wykonywania
Uzyskiwanie dostępu do regionów formularzy w czasie wykonywania