ApplicationFactory.GetVstoObject 方法 (_Workbook)

發行項
08/12/2011

傳回 Microsoft.Office.Tools.Excel.Workbook 主項目，這個主項目可擴充指定之原生活頁簿物件的功能。

命名空間： Microsoft.Office.Tools.Excel
組件： Microsoft.Office.Tools.Excel (在 Microsoft.Office.Tools.Excel.dll 中)

語法

'宣告
Function GetVstoObject ( _
    workbook As _Workbook _
) As Workbook

Workbook GetVstoObject(
    _Workbook workbook
)

參數

workbook
型別：Microsoft.Office.Interop.Excel._Workbook
要擷取其擴充物件的原生活頁簿物件。雖然這個參數的型別為 Microsoft.Office.Interop.Excel._Workbook，您通常會傳遞 Microsoft.Office.Interop.Excel.Workbook 物件給這個方法。

傳回值

型別：Microsoft.Office.Tools.Excel.Workbook
可擴充原生活頁簿物件功能的主項目。

備註

在應用程式層級增益集 (Add-In) 內呼叫這個方法，即可自訂任何以 Excel 開啟的活頁簿。如果之前沒有產生任何 Microsoft.Office.Tools.Excel.Workbook 物件，這個方法會產生此一新物件。對這個方法的後續呼叫會傳回現有 Microsoft.Office.Tools.Excel.Workbook 物件的快取執行個體 (Instance)。如需詳細資訊，請參閱在應用程式層級增益集的執行階段中擴充 Word 文件和 Excel 活頁簿。

注意事項
workbook 參數的型別是 Microsoft.Office.Interop.Excel._Workbook，此為 Microsoft.Office.Interop.Excel.Workbook 的父介面。因此，這個方法可以接受這兩種型別的物件：Microsoft.Office.Interop.Excel._Workbook 和 Microsoft.Office.Interop.Excel.Workbook。通常在參考 Excel 活頁簿時，您會使用 Microsoft.Office.Interop.Excel.Workbook。

範例

下列程式碼範例會針對使用中的 Excel 活頁簿建立 Microsoft.Office.Tools.Excel.Workbook 主項目。若要使用這個程式碼，請在以 .NET Framework 4 為目標之 Excel 增益集專案的 ThisAddIn 類別中執行該程式碼。

Dim vstoWorkbook As Workbook = _
    Globals.Factory.GetVstoObject(Me.Application.ActiveWorkbook)

For Each st As SmartTag In vstoWorkbook.VstoSmartTags
    System.Windows.Forms.MessageBox.Show(st.Caption)
Next

Workbook vstoWorkbook =
    Globals.Factory.GetVstoObject(this.Application.ActiveWorkbook);

foreach (SmartTag st in vstoWorkbook.VstoSmartTags)
{
    System.Windows.Forms.MessageBox.Show(st.Caption);
}