Metoda ApplicationFactory.GetVstoObject — (_Workbook)

Artykuł
05/08/2013

Zwraca Microsoft.Office.Tools.Excel.Workbook elementu hosta, która rozszerza funkcjonalność obiektu macierzystego skoroszyt określoną.

Przestrzeń nazw: Microsoft.Office.Tools.Excel
Zestawy: Microsoft.Office.Tools.Excel (w Microsoft.Office.Tools.Excel.dll)
Microsoft.Office.Tools.Excel.v4.0.Utilities (w Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Składnia

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

Workbook GetVstoObject(
    _Workbook workbook
)

Parametry

workbook
Typ: Microsoft.Office.Interop.Excel._Workbook
Skoroszyt macierzysty obiekt, który pobiera obiekt rozszerzone.Ten parametr jest typu Microsoft.Office.Interop.Excel._Workbook, zazwyczaj przekazać Microsoft.Office.Interop.Excel.Workbook obiektu do tej metody.

Wartość zwracana

Typ: Microsoft.Office.Tools.Excel.Workbook
Element hosta, która rozszerza funkcjonalność obiektu macierzystego skoroszytu.

Uwagi

Wywołanie tej metody dodatek programu poziomu aplikacji Aby dostosować każdy skoroszyt, który jest otwarty w programie Excel.Metoda ta umożliwia generowanie nowego Microsoft.Office.Tools.Excel.Workbook obiektu, jeśli nie ma takiego obiektu już został wygenerowany.Kolejne wywołania tej metody zwraca buforowane wystąpienie istniejących Microsoft.Office.Tools.Excel.Workbook obiektu.Aby uzyskać więcej informacji, zobacz Rozszerzanie dokumenty programu Word oraz skoroszyty programu Excel w dodatki poziomie aplikacji w czasie wykonywania.

[!UWAGA]

workbook Parametr jest typu Microsoft.Office.Interop.Excel._Workbook, który jest interfejsem nadrzędnej Microsoft.Office.Interop.Excel.Workbook.W związku z tym, ta metoda może akceptować obiekty obu typów: Microsoft.Office.Interop.Excel._Workbook i Microsoft.Office.Interop.Excel.Workbook.Zazwyczaj, gdy odwołanie do skoroszytu programu Excel, możesz wykorzystać Microsoft.Office.Interop.Excel.Workbook.

Przykłady

Poniższy przykład kodu tworzy Microsoft.Office.Tools.Excel.Workbook hosta towaru dla aktywnego skoroszytu programu Excel.Aby użyć tego kodu, uruchomić go z ThisAddIn klasy w dodatek programu Excel projektu atakującego .NET Framework 4 lub .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);
}

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Przy użyciu bibliotek z częściowo zaufanego kodu..