ListObjectExtensions.GetVstoObject-Methode (ListObject, ApplicationFactory)

Artikel
01/03/2014

Gibt ein Microsoft.Office.Tools.Excel.ListObject-Hoststeuerelement zurück, das die Funktionalität des aktuellen Microsoft.Office.Interop.Excel.ListObject-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 ( _
    listObject As ListObject, _
    factory As ApplicationFactory _
) As ListObject

public static ListObject GetVstoObject(
    this ListObject listObject,
    ApplicationFactory factory
)

Parameter

listObject
Typ: Microsoft.Office.Interop.Excel.ListObject
Das zu erweiternde systemeigene Listenobjekt.Geben Sie diesen Parameter nicht selbst an.Wenn Sie diese Methode für ein Excel-Listenobjekt 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.ListObject
Ein Hoststeuerelement, das die Funktionalität des aktuellen Microsoft.Office.Interop.Excel.ListObject-Objekts erweitert.

Hinweis zur Verwendung

In Visual Basic und C# können Sie diese Methode als Instanzenmethode für ein beliebiges Objekt vom Typ ListObject 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 einem Excel-Arbeitsblatt geöffnetes Listenobjekt zu erweitern. Diese Methode generiert ein neues Microsoft.Office.Tools.Excel.ListObject-Hoststeuerelement, wenn kein solches Objekt bereits für das Microsoft.Office.Interop.Excel.ListObject-Objekt generiert wurde, für das Sie diese Methode aufrufen. Nachfolgende Aufrufe dieser Methode für das gleiche Microsoft.Office.Interop.Excel.ListObject-Objekt geben die gleiche Microsoft.Office.Tools.Excel.ListObject-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.

.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.