ApplicationFactory.GetVstoObject-Methode (_Workbook)

Artikel
01/03/2014

Gibt ein Microsoft.Office.Tools.Excel.Workbook-Hostelement zurück, das die Funktionalität des angegebenen systemeigenen Arbeitsmappenobjekts erweitert.

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

Syntax

'Declaration
Function GetVstoObject ( _
    workbook As _Workbook _
) As Workbook

Workbook GetVstoObject(
    _Workbook workbook
)

Parameter

workbook
Typ: Microsoft.Office.Interop.Excel._Workbook
Das systemeigene Arbeitsmappenobjekt, für das das erweiterte Objekt abgerufen wird.Obwohl dieser Parameter vom Typ Microsoft.Office.Interop.Excel._Workbook ist, übergeben Sie i. d. R. ein Microsoft.Office.Interop.Excel.Workbook-Objekt an diese Methode.

Rückgabewert

Typ: Microsoft.Office.Tools.Excel.Workbook
Das Hostelement, das die Funktionalität des systemeigenen Arbeitsmappenobjekts erweitert.

Hinweise

Rufen Sie diese Methode in einem Add-In auf Anwendungsebene auf, um eine beliebige, in Excel geöffnete Arbeitsmappe anzupassen. Diese Methode generiert ein neues Microsoft.Office.Tools.Excel.Workbook-Objekt, falls ein solches Objekt nicht bereits generiert wurde. Nachfolgende Aufrufe dieser Methode geben die zwischengespeicherte Instanz des vorhandenen Microsoft.Office.Tools.Excel.Workbook-Objekts zurück. Weitere Informationen finden Sie unter Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in Add-Ins auf Anwendungsebene zur Laufzeit.

Hinweis

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.Daher kann diese Methode Objekte beider Typen akzeptieren: 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.

Beispiele

Im folgenden Codebeispiel wird ein Microsoft.Office.Tools.Excel.Workbook-Hostelement für die aktive Excel-Arbeitsmappe erstellt. Wenn Sie diesen Code verwenden möchten, führen Sie ihn von der ThisAddIn-Klasse in einem Excel-Add-In-Projekt aus, dessen Ziel .NET Framework 4 oder .NET Framework 4.5 ist.

Dim vstoWorkbook As Workbook = _
    Globals.Factory.GetVstoObject(Me.Application.ActiveWorkbook)

For Each st As SmartTag In vstoWorkbook.VstoSmartTags
    System.Windows.Forms.MessageBox.Show(st.Caption)
Next

Workbook vstoWorkbook =
    Globals.Factory.GetVstoObject(this.Application.ActiveWorkbook);

foreach (SmartTag st in vstoWorkbook.VstoSmartTags)
{
    System.Windows.Forms.MessageBox.Show(st.Caption);
}

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