Metodo WorkbookExtensions.GetVstoObject (_Workbook, ApplicationFactory)

Articolo
01/06/2014

Restituisce un elemento host Microsoft.Office.Tools.Excel.Workbook che estende la funzionalità dell'oggetto Microsoft.Office.Interop.Excel.Workbook corrente in un componente aggiuntivo a livello di applicazione. Passa l'oggetto Globals.Factory nel progetto nel parametro factory.

Spazio dei nomi: Microsoft.Office.Tools.Excel.Extensions
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintassi

'Dichiarazione
<ExtensionAttribute> _
Public Shared Function GetVstoObject ( _
    workbook As _Workbook, _
    factory As ApplicationFactory _
) As Workbook

public static Workbook GetVstoObject(
    this _Workbook workbook,
    ApplicationFactory factory
)

Parametri

workbook
Tipo: Microsoft.Office.Interop.Excel._Workbook
Oggetto cartella di lavoro nativa da estendere.Non fornire questo parametro.Quando si chiama questo metodo su una cartella di lavoro di Excel, il runtime fornisce questo parametro.

factory
Tipo: Microsoft.Office.Tools.Excel.ApplicationFactory
Oggetto che fornisce accesso a funzionalità determinate nel componente aggiuntivo a livello di applicazione.Passa l'oggetto Globals.Factory nel parametro.

Valore restituito

Tipo: Microsoft.Office.Tools.Excel.Workbook
Restituisce un elemento host che estende la funzionalità dell'oggetto Microsoft.Office.Interop.Excel.Workbook corrente.

Nota sull'utilizzo

In Visual Basic e C# è possibile chiamare questo metodo come metodo di istanza su qualsiasi oggetto di tipo _Workbook. Per chiamare il metodo utilizzando la sintassi del metodo di istanza, omettere il primo parametro. Per ulteriori informazioni, vedere Metodi di estensione (Visual Basic) o Metodi di estensione (Guida per programmatori C#).

Note

In un componente aggiuntivo a livello di applicazione chiamare questo metodo per estendere qualsiasi cartella di lavoro aperta in Excel. Questo metodo genera un nuovo elemento host Microsoft.Office.Tools.Excel.Workbook se nessun oggetto di questo tipo è già stato generato per l'oggetto Microsoft.Office.Interop.Excel.Workbook sul quale si chiama questo metodo. Le chiamate successive a questo metodo sullo stesso oggetto Microsoft.Office.Interop.Excel.Workbook restituiscono la stessa istanza Microsoft.Office.Tools.Excel.Workbook.

Questo metodo viene fornito per compatibilità con le versioni precedenti dei progetti Office che sono stati ridestinati da .NET Framework 3.5 a .NET Framework 4 o a .NET Framework 4.5. Nei nuovi progetti destinati a .NET Framework 4 o .NET Framework 4.5, è necessario chiamare il metodo GetVstoObject fornito dall'oggetto Globals.Factory nel progetto.

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

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.