全域存取 Visual Studio Tools for Office 專案中的物件

發行項
09/10/2008

更新：2007 年 11 月

您可以使用 Globals 類別 (Class)，從專案的任何程式碼中存取多個不同的專案項目。

如何使用 Globals

Globals 是靜態類別，這個靜態類別會將項目參考保留在專案中。您可以使用 Globals 類別，從專案中的任何程式碼參考下列項目：

Excel 活頁簿 (Workbook) 或範本專案中的 Workbook 或任何 Worksheet 主項目。您可以使用參考專案中每個主項目之 Globals 類別的屬性，即可存取這些主項目。主項目名稱預設為 ThisWorkbook、Sheet1、Sheet2 和 Sheet3。
Word 文件或範本專案中的 Document 主項目。這個主項目屬性的預設名稱為 Globals.ThisDocument。
應用程式層級專案中的 AddIn 主項目。這個主項目屬性的預設名稱為 Globals.ThisAddIn。
專案中使用 [功能區設計工具] 自訂的所有功能區。您可以使用 Globals.Ribbons 屬性存取功能區。
Outlook 增益集專案中的所有 Outlook 表單區域。您可以使用 Globals.FormRegions 屬性存取表單區域。

例如，您可以撰寫程式碼，在使用者按一下執行窗格上的按鈕時，將文字插入至 Sheet1 上的 NamedRange 控制項 (如下面範例所示)。

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

初始化 Globals 類別

嘗試在文件或增益集完全初始化之前使用 Globals 類別的程式碼，可能會擲回執行階段例外狀況 (Exception)。例如，在宣告類別層級的變數時使用 Globals 可能會失敗，因為 Globals 類別可能不會在宣告的物件具現化之前，使用所有主項目的參考進行初始化。

注意事項：
雖然 Globals 類別絕對不會在設計階段初始化，但是設計工具卻會建立控制項執行個體。這表示如果您建立會呼叫 Globals 類別之方法的使用者控制項，您必須撰寫程式碼，在嘗試存取方法之前，檢查該方法是否會傳回 null。