WorkbookExtensions.GetVstoObject Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| GetVstoObject(_Workbook, ApplicationFactory) |
Gibt ein Workbook-Hostelement zurück, das die Funktionalität des aktuellen Workbook-Objekts in einem Add-In auf Anwendungsebene erweitert. Übergeben Sie das Globals.Factory-Objekt in Ihrem Projekt an den |
| GetVstoObject(_Workbook, Factory) |
Gibt ein Workbook-Hostelement zurück, das die Funktionalität des aktuellen Workbook-Objekts in einer Anpassung auf Anwendungsebene erweitert. Übergeben Sie das Globals.Factory-Objekt in Ihrem Projekt an den |
GetVstoObject(_Workbook, ApplicationFactory)
public:
[System::Runtime::CompilerServices::Extension]
static Microsoft::Office::Tools::Excel::Workbook ^ GetVstoObject(Microsoft::Office::Interop::Excel::_Workbook ^ workbook, Microsoft::Office::Tools::Excel::ApplicationFactory ^ factory);public static Microsoft.Office.Tools.Excel.Workbook GetVstoObject (this Microsoft.Office.Interop.Excel._Workbook workbook, Microsoft.Office.Tools.Excel.ApplicationFactory factory);static member GetVstoObject : Microsoft.Office.Interop.Excel._Workbook * Microsoft.Office.Tools.Excel.ApplicationFactory -> Microsoft.Office.Tools.Excel.Workbook<Extension()>
Public Function GetVstoObject (workbook As _Workbook, factory As ApplicationFactory) As WorkbookParameter
- workbook
- _Workbook
Das zu erweiternde native Arbeitsmappenobjekt. Geben Sie diesen Parameter nicht selbst an. Wenn Sie die Methode für eine Excel-Arbeitsmappe aufrufen, gibt die Laufzeit diesen Parameter an.
- factory
- ApplicationFactory
Ein Objekt, das Zugriff auf bestimmte Funktionen im Add-In auf Anwendungsebene bereitstellt. Übergeben Sie das Globals.Factory-Objekt an diesen Parameter.
Gibt zurück
Ein Hostelement, das die Funktionalität des aktuellen Workbook-Objekts erweitert.
Hinweise
Rufen Sie in einem Add-In auf Anwendungsebene diese Methode auf, um jede Arbeitsmappe zu erweitern, die in Excel geöffnet ist. Diese Methode generiert ein neues Microsoft.Office.Tools.Excel.Workbook Hostelement, wenn für das Objekt, für das Microsoft.Office.Interop.Excel.Workbook Sie diese Methode aufrufen, bereits kein solches Objekt generiert wurde. Nachfolgende Aufrufe dieser Methode für dasselbe Microsoft.Office.Interop.Excel.Workbook Objekt geben denselben Microsoft.Office.Tools.Excel.Workbook instance zurück.
Diese Methode wird für die Abwärtskompatibilität mit Office-Projekten bereitgestellt, die Sie von der .NET Framework 3.5 auf die .NET Framework 4 oder die .NET Framework 4.5 umstellen. In neuen Projekten, die auf die .NET Framework 4 oder die .NET Framework 4.5 abzielen, sollten Sie die GetVstoObject Methode aufrufen, die Globals.Factory vom Objekt in Ihrem Projekt bereitgestellt wird.
Weitere Informationen finden Sie unter Extending Word Documents and Excel Workbooks in VSTO Add-ins at Run Time.
Hinweis
Der workbook Parameter ist vom Typ Microsoft.Office.Interop.Excel._Workbook, der die übergeordnete Schnittstelle von Microsoft.Office.Interop.Excel.Workbookist. Daher erweitert diese Methode beide Typen: Microsoft.Office.Interop.Excel._Workbook und Microsoft.Office.Interop.Excel.Workbook. Wenn Sie auf eine Excel-Arbeitsmappe verweisen, verwenden Sie in der Regel eine Microsoft.Office.Interop.Excel.Workbook.
Gilt für:
GetVstoObject(_Workbook, Factory)
public:
[System::Runtime::CompilerServices::Extension]
static Microsoft::Office::Tools::Excel::Workbook ^ GetVstoObject(Microsoft::Office::Interop::Excel::_Workbook ^ workbook, Microsoft::Office::Tools::Excel::Factory ^ factory);public static Microsoft.Office.Tools.Excel.Workbook GetVstoObject (this Microsoft.Office.Interop.Excel._Workbook workbook, Microsoft.Office.Tools.Excel.Factory factory);static member GetVstoObject : Microsoft.Office.Interop.Excel._Workbook * Microsoft.Office.Tools.Excel.Factory -> Microsoft.Office.Tools.Excel.Workbook<Extension()>
Public Function GetVstoObject (workbook As _Workbook, factory As Factory) As WorkbookParameter
- workbook
- _Workbook
Das zu erweiternde native Arbeitsmappenobjekt. Geben Sie diesen Parameter nicht selbst an. Wenn Sie die Methode für eine Excel-Arbeitsmappe aufrufen, gibt die Laufzeit diesen Parameter an.
- factory
- Factory
Ein Objekt, das Zugriff auf bestimmte Funktionen in der Anpassung auf Dokumentebene bereitstellt. Übergeben Sie das Globals.Factory-Objekt an diesen Parameter.
Gibt zurück
Ein Hostelement, das die Funktionalität des aktuellen Workbook-Objekts erweitert.
Hinweise
Bei einer Anpassung auf Dokumentebene können Sie diese Methode aufrufen, um ein Microsoft.Office.Tools.Excel.Workbook Hostelement abzurufen, das sich in der aktuellen Anpassung befindet. Wenn das Microsoft.Office.Interop.Excel.Workbook Objekt, für das Sie diese Methode aufrufen, nicht das zugrunde liegende Objekt eines Microsoft.Office.Tools.Excel.Workbook Hostelements in der aktuellen Anpassung ist, gibt diese Methode zurück null.
Diese Methode wird für die Abwärtskompatibilität mit Office-Projekten bereitgestellt, die Sie von der .NET Framework 3.5 auf die .NET Framework 4 oder die .NET Framework 4.5 umstellen. In neuen Projekten, die auf die .NET Framework 4 oder die .NET Framework 4.5 abzielen, sollten Sie die GetVstoObject Methode aufrufen, die Globals.Factory vom Objekt in Ihrem Projekt bereitgestellt wird. Weitere Informationen finden Sie unter Programming Document-Level Customizations.
Hinweis
Der workbook Parameter ist vom Typ Microsoft.Office.Interop.Excel._Workbook, der die übergeordnete Schnittstelle von Microsoft.Office.Interop.Excel.Workbookist. Daher erweitert diese Methode beide Typen: Microsoft.Office.Interop.Excel._Workbook und Microsoft.Office.Interop.Excel.Workbook. Wenn Sie auf eine Excel-Arbeitsmappe verweisen, verwenden Sie in der Regel eine Microsoft.Office.Interop.Excel.Workbook.