WorksheetExtensions.GetVstoObject-Methode (_Worksheet, ApplicationFactory)

Artikel
01/03/2014

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

Namespace: Microsoft.Office.Tools.Excel.Extensions
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntax

'Declaration
<ExtensionAttribute> _
Public Shared Function GetVstoObject ( _
    worksheet As _Worksheet, _
    factory As ApplicationFactory _
) As Worksheet

public static Worksheet GetVstoObject(
    this _Worksheet worksheet,
    ApplicationFactory factory
)

Parameter

worksheet
Typ: Microsoft.Office.Interop.Excel._Worksheet
Das zu erweiternde systemeigene Arbeitsblattobjekt.Geben Sie diesen Parameter nicht selbst an.Wenn Sie diese Methode für ein Excel-Arbeitsblatt aufrufen, gibt die Laufzeit diesen Parameter an.

factory
Typ: Microsoft.Office.Tools.Excel.ApplicationFactory
Ein Objekt, das den Zugriff auf bestimmte Funktionen im Add-In auf Anwendungsebene ermöglicht.Übergeben Sie das Globals.Factory-Objekt an diesen Parameter.

Rückgabewert

Typ: Microsoft.Office.Tools.Excel.Worksheet
Ein Hostelement, das die Funktionalität des aktuellen Microsoft.Office.Interop.Excel.Worksheet-Objekts erweitert.

Hinweis zur Verwendung

In Visual Basic und C# können Sie diese Methode als Instanzenmethode für ein beliebiges Objekt vom Typ _Worksheet aufrufen. Bei Verwendung der Syntax für Instanzenmethoden lassen Sie den ersten Parameter aus. Weitere Informationen finden Sie unter Erweiterungsmethoden (Visual Basic) und Erweiterungsmethoden (C#-Programmierhandbuch).

Hinweise

Rufen Sie diese Methode in einem Add-In auf Anwendungsebene auf, um ein beliebiges, in Excel geöffnetes Arbeitsblatt zu erweitern. Diese Methode generiert ein neues Microsoft.Office.Tools.Excel.Worksheet-Hostelement, wenn kein solches Objekt bereits für das Microsoft.Office.Interop.Excel.Worksheet-Objekt generiert wurde, für das Sie diese Methode aufrufen. Nachfolgende Aufrufe dieser Methode für das gleiche Microsoft.Office.Interop.Excel.Worksheet-Objekt geben die gleiche Microsoft.Office.Tools.Excel.Worksheet-Instanz zurück.

Diese Methode wird zur Abwärtskompatibilität mit Office-Projekten bereitgestellt, für die das Ziel von .NET Framework 3.5 auf .NET Framework 4 oder .NET Framework 4.5 umgestellt wird. In neuen Projekten, die .NET Framework 4 oder .NET Framework 4.5 als Ziel haben, sollten Sie die GetVstoObject-Methode aufrufen, die vom Globals.Factory-Objekt im Projekt bereitgestellt wird.

Weitere Informationen finden Sie unter Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in Add-Ins auf Anwendungsebene zur Laufzeit.

Hinweis

Der worksheet-Parameter ist vom Typ Microsoft.Office.Interop.Excel._Worksheet. Bei diesem handelt es sich um die übergeordnete Schnittstelle von Microsoft.Office.Interop.Excel.Worksheet.Deshalb erweitert diese Methode beide Typen: Microsoft.Office.Interop.Excel._Worksheet und Microsoft.Office.Interop.Excel.Worksheet.Normalerweise wird ein Microsoft.Office.Interop.Excel.Worksheet verwendet, um auf ein Excel-Arbeitsblatt zu verweisen.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.