WorkbookExtensions.GetVstoObject 方法 (_Workbook, Factory)

發行項
05/07/2013

傳回 Microsoft.Office.Tools.Excel.Workbook 主項目，這個主項目可在文件層級自訂中擴充目前 Microsoft.Office.Interop.Excel.Workbook 物件的功能。將專案中的 Globals.Factory 物件傳遞給 factory 參數。

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

語法

'宣告
<ExtensionAttribute> _
Public Shared Function GetVstoObject ( _
    workbook As _Workbook, _
    factory As Factory _
) As Workbook

public static Workbook GetVstoObject(
    this _Workbook workbook,
    Factory factory
)

參數

workbook
型別：Microsoft.Office.Interop.Excel._Workbook
要擴充的原生活頁簿物件。請勿自行提供此參數。當您在 Excel 活頁簿上呼叫這個方法時，執行階段就會提供此參數。

factory
型別：Microsoft.Office.Tools.Excel.Factory
物件，這個物件會提供文件層級自訂中特定功能的存取權。將 Globals.Factory 物件傳遞給這個參數。

傳回值

型別：Microsoft.Office.Tools.Excel.Workbook
主項目，可擴充目前 Microsoft.Office.Interop.Excel.Workbook 物件的功能。

使用注意事項

在 Visual Basic 和 C# 中，您可以在任何 _Workbook 型別物件中呼叫這個方法以做為執行個體。使用執行個體方法語法呼叫這個方法時，請省略第一個參數。如需詳細資訊，請參閱擴充方法 (Visual Basic)或擴充方法 (C# 程式設計手冊)。

備註

在文件層級自訂中，您可以呼叫這個方法以取得位於目前自訂中的 Microsoft.Office.Tools.Excel.Workbook 主項目。如果您呼叫這個方法所在的 Microsoft.Office.Interop.Excel.Workbook 物件在目前自訂中不是 Microsoft.Office.Tools.Excel.Workbook 主項目的基礎物件，這個方法會傳回 nullnull 參考 (即 Visual Basic 中的 Nothing)。

這個方法以提供回溯相容性隨 Office 專案從 .NET Framework 3.5 為目標的 .NET Framework 4 或 .NET Framework 4.5。在以 .NET Framework 4 或 .NET Framework 4.5的新專案，您應該呼叫在專案中 Globals.Factory 物件的 GetVstoObject 方法。如需詳細資訊，請參閱文件層級自訂程式設計。

注意事項
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。