WorkbookExtensions.HasVstoObject-Methode (_Workbook, ApplicationFactory)

Artikel
08/10/2011

Gibt einen Wert zurück, der angibt, ob ein Microsoft.Office.Tools.Excel.Workbook-Hostelement für das aktuelle Microsoft.Office.Interop.Excel.Workbook-Objekt in einem Add-In auf Anwendungsebene erstellt wurde. Ü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 HasVstoObject ( _
    workbook As _Workbook, _
    factory As ApplicationFactory _
) As Boolean

public static bool HasVstoObject(
    this _Workbook workbook,
    ApplicationFactory factory
)

Parameter

workbook
Typ: Microsoft.Office.Interop.Excel._Workbook
Das zu testende systemeigene Arbeitsmappenobjekt.Geben Sie diesen Parameter nicht selbst an.Wenn Sie diese Methode für eine Excel-Arbeitsmappe 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: System.Boolean
true, wenn für das aktuelle Microsoft.Office.Interop.Excel.Workbook-Objekt ein Microsoft.Office.Tools.Excel.Workbook-Hostelement erstellt wurde, andernfalls false.

Hinweis zur Verwendung

In Visual Basic und C# können Sie diese Methode als Instanzenmethode für ein beliebiges Objekt vom Typ _Workbook 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

In einem Add-In auf Anwendungsebene können Sie diese Methode aufrufen, um zu ermitteln, ob ein Microsoft.Office.Tools.Excel.Workbook-Hostelement für ein Microsoft.Office.Interop.Excel.Workbook-Objekt vorhanden ist. Meist verwenden Sie diese Methode, um zu überprüfen, ob verwaltete Steuerelemente vorhanden sind, die beibehalten werden sollen, bevor Sie eine Excel-Arbeitsmappe schließen oder speichern.

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 umgestellt wird. In neuen Projekten, die auf den .NET Framework 4 abzielen, 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.

Tipp

Der Workbook-Parameter ist vom Typ Microsoft.Office.Interop.Excel._Workbook, bei dem es sich um die übergeordnete Schnittstelle von Microsoft.Office.Interop.Excel.Workbook handelt. Deshalb erweitert diese Methode beide Typen: Microsoft.Office.Interop.Excel._Workbook und Microsoft.Office.Interop.Excel.Workbook. Normalerweise verwenden Sie eine Microsoft.Office.Interop.Excel.Workbook, um auf eine Excel-Arbeitsmappe 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.