Freigeben über


WorksheetExtensions.GetVstoObject Methode

Definition

Überlädt

GetVstoObject(_Worksheet, ApplicationFactory)

Gibt ein Worksheet-Hostelement zurück, das die Funktionalität des aktuellen Worksheet-Objekts in einem Add-In auf Anwendungsebene erweitert. Übergeben Sie das Globals.Factory-Objekt in Ihrem Projekt an den factory-Parameter.

GetVstoObject(_Worksheet, Factory)

Gibt ein Worksheet-Hostelement zurück, das die Funktionalität des aktuellen Worksheet-Objekts in einer Anpassung auf Anwendungsebene erweitert. Übergeben Sie das Globals.Factory-Objekt in Ihrem Projekt an den factory-Parameter.

GetVstoObject(_Worksheet, ApplicationFactory)

Gibt ein Worksheet-Hostelement zurück, das die Funktionalität des aktuellen Worksheet-Objekts in einem Add-In auf Anwendungsebene erweitert. Übergeben Sie das Globals.Factory-Objekt in Ihrem Projekt an den factory-Parameter.

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

Parameter

worksheet
_Worksheet

Das zu erweiternde native Arbeitsblattobjekt. Geben Sie diesen Parameter nicht selbst an. Wenn Sie die Methode für ein Excel-Arbeitsblatt 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 Worksheet-Objekts erweitert.

Hinweise

Rufen Sie in einem Add-In auf Anwendungsebene diese Methode auf, um jedes arbeitsblatt zu erweitern, das in Excel geöffnet ist. Diese Methode generiert ein neues Microsoft.Office.Tools.Excel.Worksheet Hostelement, wenn für das Objekt, für das Microsoft.Office.Interop.Excel.Worksheet Sie diese Methode aufrufen, bereits kein solches Objekt generiert wurde. Nachfolgende Aufrufe dieser Methode für dasselbe Microsoft.Office.Interop.Excel.Worksheet Objekt geben den gleichen Microsoft.Office.Tools.Excel.Worksheet 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 worksheet Parameter ist vom Typ Microsoft.Office.Interop.Excel._Worksheet, der die übergeordnete Schnittstelle von Microsoft.Office.Interop.Excel.Worksheetist. Daher erweitert diese Methode beide Typen: Microsoft.Office.Interop.Excel._Worksheet und Microsoft.Office.Interop.Excel.Worksheet. Wenn Sie auf ein Excel-Arbeitsblatt verweisen, verwenden Sie in der Regel eine Microsoft.Office.Interop.Excel.Worksheet.

Gilt für:

GetVstoObject(_Worksheet, Factory)

Gibt ein Worksheet-Hostelement zurück, das die Funktionalität des aktuellen Worksheet-Objekts in einer Anpassung auf Anwendungsebene erweitert. Übergeben Sie das Globals.Factory-Objekt in Ihrem Projekt an den factory-Parameter.

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

Parameter

worksheet
_Worksheet

Das zu erweiternde native Arbeitsblattobjekt. Geben Sie diesen Parameter nicht selbst an. Wenn Sie die Methode für ein Excel-Arbeitsblatt 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 Worksheet-Objekts erweitert.

Hinweise

In einer Anpassung auf Dokumentebene können Sie diese Methode aufrufen, um ein Microsoft.Office.Tools.Excel.Worksheet Hostelement abzurufen, das sich in der aktuellen Anpassung befindet. Wenn das Microsoft.Office.Interop.Excel.Worksheet Objekt, für das Sie diese Methode aufrufen, nicht das zugrunde liegende Objekt eines Microsoft.Office.Tools.Excel.Worksheet 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 worksheet Parameter ist vom Typ Microsoft.Office.Interop.Excel._Worksheet, der die übergeordnete Schnittstelle von Microsoft.Office.Interop.Excel.Worksheetist. Daher erweitert diese Methode beide Typen: Microsoft.Office.Interop.Excel._Worksheet und Microsoft.Office.Interop.Excel.Worksheet. Wenn Sie auf ein Excel-Arbeitsblatt verweisen, verwenden Sie in der Regel eine Microsoft.Office.Interop.Excel.Worksheet.

Gilt für: