WorksheetExtensions.GetVstoObject 方法

定義

多載

GetVstoObject(_Worksheet, ApplicationFactory)

傳回 Worksheet 主項目,其可擴充應用程式層級增益集中目前 Worksheet 物件的功能。 將專案中的 Globals.Factory 物件傳遞給 factory 參數。

GetVstoObject(_Worksheet, Factory)

傳回 Worksheet 主項目,可擴充文件層級自訂中目前 Worksheet 物件的功能。 將專案中的 Globals.Factory 物件傳遞給 factory 參數。

GetVstoObject(_Worksheet, ApplicationFactory)

傳回 Worksheet 主項目,其可擴充應用程式層級增益集中目前 Worksheet 物件的功能。 將專案中的 Globals.Factory 物件傳遞給 factory 參數。

public:
[System::Runtime::CompilerServices::Extension]
 static Microsoft::Office::Tools::Excel::Worksheet ^ GetVstoObject(Microsoft::Office::Interop::Excel::_Worksheet ^ worksheet, Microsoft::Office::Tools::Excel::ApplicationFactory ^ factory);
public static Microsoft.Office.Tools.Excel.Worksheet GetVstoObject (this Microsoft.Office.Interop.Excel._Worksheet worksheet, Microsoft.Office.Tools.Excel.ApplicationFactory factory);
static member GetVstoObject : Microsoft.Office.Interop.Excel._Worksheet * Microsoft.Office.Tools.Excel.ApplicationFactory -> Microsoft.Office.Tools.Excel.Worksheet
<Extension()>
Public Function GetVstoObject (worksheet As _Worksheet, factory As ApplicationFactory) As Worksheet

參數

worksheet
_Worksheet

要擴充的原生工作表物件。 請不要自行提供這個參數。 當您在 Excel 工作表上呼叫這個方法時,執行階段會提供這個參數。

factory
ApplicationFactory

提供應用程式層級增益集中特定功能之存取權的物件。 將 Globals.Factory 物件傳遞給這個參數。

傳回

可擴充目前 Worksheet 物件之功能的主項目。

備註

在應用層級載入宏中,呼叫此方法以擴充在Excel中開啟的任何工作表。 如果尚未針對您呼叫這個方法的對象產生這類物件,Microsoft.Office.Interop.Excel.Worksheet這個方法會產生新的Microsoft.Office.Tools.Excel.Worksheet主專案。 相同 Microsoft.Office.Interop.Excel.Worksheet 物件上的這個方法後續呼叫會傳回相同的 Microsoft.Office.Tools.Excel.Worksheet 實例。

這個方法可讓您與從 .NET Framework 3.5 到 .NET Framework 4 或 .NET Framework 4.5 的 Office 專案回溯兼容性。 在以 .NET Framework 4 或 .NET Framework 4.5 為目標的新專案中,您應該呼叫GetVstoObject項目中物件所提供的 Globals.Factory 方法。

如需詳細資訊,請參閱 Extending Word Documents and Excel Workbooks in VSTO Add-ins at Run Time

注意

參數 worksheet 的類型為 Microsoft.Office.Interop.Excel._Worksheet,這是 的 Microsoft.Office.Interop.Excel.Worksheet父介面。 因此,這個方法會擴充這兩種類型: Microsoft.Office.Interop.Excel._WorksheetMicrosoft.Office.Interop.Excel.Worksheet。 一般而言,當您參考 Excel 工作表時,您會使用 Microsoft.Office.Interop.Excel.Worksheet

適用於

GetVstoObject(_Worksheet, Factory)

傳回 Worksheet 主項目,可擴充文件層級自訂中目前 Worksheet 物件的功能。 將專案中的 Globals.Factory 物件傳遞給 factory 參數。

public:
[System::Runtime::CompilerServices::Extension]
 static Microsoft::Office::Tools::Excel::Worksheet ^ GetVstoObject(Microsoft::Office::Interop::Excel::_Worksheet ^ worksheet, Microsoft::Office::Tools::Excel::Factory ^ factory);
public static Microsoft.Office.Tools.Excel.Worksheet GetVstoObject (this Microsoft.Office.Interop.Excel._Worksheet worksheet, Microsoft.Office.Tools.Excel.Factory factory);
static member GetVstoObject : Microsoft.Office.Interop.Excel._Worksheet * Microsoft.Office.Tools.Excel.Factory -> Microsoft.Office.Tools.Excel.Worksheet
<Extension()>
Public Function GetVstoObject (worksheet As _Worksheet, factory As Factory) As Worksheet

參數

worksheet
_Worksheet

要擴充的原生工作表物件。 請不要自行提供這個參數。 當您在 Excel 工作表上呼叫這個方法時,執行階段會提供這個參數。

factory
Factory

提供文件層級自訂中特定功能之存取權的物件。 將 Globals.Factory 物件傳遞給這個參數。

傳回

可擴充目前 Worksheet 物件之功能的主項目。

備註

在文件層級自定義中,您可以呼叫此方法來取得 Microsoft.Office.Tools.Excel.Worksheet 目前自定義中的主專案。 Microsoft.Office.Interop.Excel.Worksheet如果您呼叫這個方法的物件不是目前自訂中主項目的基礎物件Microsoft.Office.Tools.Excel.Worksheet,這個方法會傳null回 。

這個方法可讓您與從 .NET Framework 3.5 到 .NET Framework 4 或 .NET Framework 4.5 的 Office 專案回溯兼容性。 在以 .NET Framework 4 或 .NET Framework 4.5 為目標的新專案中,您應該呼叫GetVstoObject項目中物件所提供的 Globals.Factory 方法。 如需詳細資訊,請參閱 Programming Document-Level Customizations

注意

參數 worksheet 的類型為 Microsoft.Office.Interop.Excel._Worksheet,這是 的 Microsoft.Office.Interop.Excel.Worksheet父介面。 因此,這個方法會擴充這兩種類型: Microsoft.Office.Interop.Excel._WorksheetMicrosoft.Office.Interop.Excel.Worksheet。 一般而言,當您參考 Excel 工作表時,您會使用 Microsoft.Office.Interop.Excel.Worksheet

適用於