ApplicationFactory.GetVstoObject – metoda (_Workbook)

Článek
08/11/2011

Vrátí Microsoft.Office.Tools.Excel.Workbook hostitele zboží, který rozšiřuje funkčnost objektu zadaného nativní sešitu.

Obor názvů: Microsoft.Office.Tools.Excel
Sestavení: Microsoft.Office.Tools.Excel (v Microsoft.Office.Tools.Excel.dll)

Syntaxe

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

Workbook GetVstoObject(
    _Workbook workbook
)

Parametry

workbook
Typ: Microsoft.Office.Interop.Excel._Workbook
nativní sešitu objekt pro které chcete načíst rozšířené objekt.Ačkoli je tento parametr typu Microsoft.Office.Interop.Excel._Workbook, obvykle předat Microsoft.Office.Interop.Excel.Workbook objekt metody.

Vrácená hodnota

Typ: Microsoft.Office.Tools.Excel.Workbook
hostitelpoložka , která rozšiřuje funkce sešitu nativní objekt.

Poznámky

Volání této metoda aplikace-úroveň doplněk upravit libovolný sešit, který je otevřený v aplikaci Excel. Tato metoda generuje nový Microsoft.Office.Tools.Excel.Workbook objektu, pokud žádný takový objekt již byl vygenerován. Následná volání této metody vrátit mezipaměti existující instanci Microsoft.Office.Tools.Excel.Workbook objektu. Další informace naleznete v tématu Extending Word Documents and Excel Workbooks in Application-Level Add-ins at Run Time.

Poznámka

workbook Typ parametru je Microsoft.Office.Interop.Excel._Workbook, která je nadřazená rozhraní Microsoft.Office.Interop.Excel.Workbook. Tuto metoda lze proto přijmout obou typů objektů: Microsoft.Office.Interop.Excel._Workbookand Microsoft.Office.Interop.Excel.Workbook. Obvykle při odkazu na sešit aplikace Excel použít Microsoft.Office.Interop.Excel.Workbook.

Příklady

Následující příklad kódu vytváří Microsoft.Office.Tools.Excel.Workbook hostitel položka aktivního sešitu aplikace Excel. Chcete-li použít tento kód spustit z ThisAddInExcel doplněkaplikaceprojekt kterýtřída .NET Framework 4.

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);
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.