Metodo ApplicationFactory.GetVstoObject (_Workbook)

Articolo
01/06/2014

Restituisce un elemento host Microsoft.Office.Tools.Excel.Workbook che estende la funzionalità dell'oggetto cartella di lavoro nativo specificato.

Spazio dei nomi: Microsoft.Office.Tools.Excel
Assembly: 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)

Sintassi

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

Workbook GetVstoObject(
    _Workbook workbook
)

Parametri

workbook
Tipo: Microsoft.Office.Interop.Excel._Workbook
Oggetto cartella di lavoro nativo per il quale recuperare l'oggetto esteso.Sebbene questo parametro sia di tipo Microsoft.Office.Interop.Excel._Workbook, a questo metodo viene in genere passato un oggetto Microsoft.Office.Interop.Excel.Workbook.

Valore restituito

Tipo: Microsoft.Office.Tools.Excel.Workbook
Elemento host che estende la funzionalità dell'oggetto cartella di lavoro nativo.

Note

Chiamare questo metodo in un componente aggiuntivo a livello di applicazione per personalizzare qualsiasi cartella di lavoro aperta in Excel. Questo metodo genera un nuovo oggetto Microsoft.Office.Tools.Excel.Workbook se un oggetto di questo tipo non è già stato generato. Le chiamate successive a questo metodo restituiscono l'istanza memorizzata nella cache dell'oggetto Microsoft.Office.Tools.Excel.Workbook esistente. Per ulteriori informazioni, vedere Estensione in fase di esecuzione di documenti di Word e di cartelle di lavoro di Excel in componenti aggiuntivi a livello di applicazione.

Nota

Il parametro workbook è di tipo Microsoft.Office.Interop.Excel._Workbook, che è l'interfaccia padre di Microsoft.Office.Interop.Excel.Workbook.Pertanto, questo metodo può accettare oggetti di entrambi i tipi: Microsoft.Office.Interop.Excel._Workbook e Microsoft.Office.Interop.Excel.Workbook.In genere, quando si fa riferimento a una cartella di lavoro di Excel, si utilizza un oggetto Microsoft.Office.Interop.Excel.Workbook.

Esempi

Nell'esempio di codice riportato di seguito viene creato un elemento host Microsoft.Office.Tools.Excel.Workbook per la cartella di lavoro attiva di Excel. Per utilizzare questo codice, eseguirlo dalla classe ThisAddIn in un progetto di componente aggiuntivo di Excel destinato a .NET Framework 4 o .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);
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.