ApplicationFactory.GetVstoObject – metoda (_Workbook)

Článek
05/14/2013

Vrátí Microsoft.Office.Tools.Excel.Workbook zboží hostitele, 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)
Microsoft.Office.Tools.Excel.v4.0.Utilities (v Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntaxe

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

Workbook GetVstoObject(
    _Workbook workbook
)

Parametry

workbook
Typ: Microsoft.Office.Interop.Excel._Workbook
Původní sešit objektu, který pro získání rozšířených objektu.Ačkoli je tento parametr je typu Microsoft.Office.Interop.Excel._Workbook, obvykle předáte Microsoft.Office.Interop.Excel.Workbook objekt do této metody.

Vrácená hodnota

Typ: Microsoft.Office.Tools.Excel.Workbook
Položku hostitele, který rozšiřuje funkčnost objektu nativní sešitu.

Poznámky

Tuto metodu volejte v doplněk na aplikační úrovni přizpůsobení sešitu, který je otevřen v aplikaci Excel.Tato metoda vytvoří nový Microsoft.Office.Tools.Excel.Workbook objekt, pokud již byl generován žádný takový objekt.Následující volání tato metoda vrací mezipaměti instanci existující Microsoft.Office.Tools.Excel.Workbook objektu.Další informace naleznete v tématu Rozšíření dokumenty aplikace Word a Excel v doplňky úroveň aplikace v době spuštění.

[!POZNÁMKA]

workbook Typ parametru je Microsoft.Office.Interop.Excel._Workbook, což je nadřazený rozhraní Microsoft.Office.Interop.Excel.Workbook.Proto tato metoda může přijímat objekty obou typů: Microsoft.Office.Interop.Excel._Workbook a Microsoft.Office.Interop.Excel.Workbook.Obvykle při odkazu na sešit aplikace Excel, můžete použít Microsoft.Office.Interop.Excel.Workbook.

Příklady

Následující příklad kódu vytvoří Microsoft.Office.Tools.Excel.Workbook položku hostitele pro aktivní sešit aplikace Excel.Chcete-li použít tento kód, spusťte jej z ThisAddIn třídy v doplňku aplikace Excel projekt, který se zaměřuje .NET Framework 4 nebo .NET Framework 4.5.

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.