Metodo WorksheetExtensions.GetVstoObject (_Worksheet, ApplicationFactory)

Articolo
01/06/2014

Restituisce un elemento host Microsoft.Office.Tools.Excel.Worksheet che estende la funzionalità dell'oggetto Microsoft.Office.Interop.Excel.Worksheet 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 ( _
    worksheet As _Worksheet, _
    factory As ApplicationFactory _
) As Worksheet

public static Worksheet GetVstoObject(
    this _Worksheet worksheet,
    ApplicationFactory factory
)

Parametri

worksheet
Tipo: Microsoft.Office.Interop.Excel._Worksheet
Oggetto foglio di lavoro nativo da estendere.Non fornire questo parametro.Quando si chiama questo metodo su un foglio 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.Worksheet
Restituisce un elemento host che estende la funzionalità dell'oggetto Microsoft.Office.Interop.Excel.Worksheet corrente.

Nota sull'utilizzo

In Visual Basic e C# è possibile chiamare questo metodo come metodo di istanza su qualsiasi oggetto di tipo _Worksheet. 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 foglio di lavoro aperto in Excel. Questo metodo genera un nuovo elemento host Microsoft.Office.Tools.Excel.Worksheet se nessun oggetto di questo tipo è già stato generato per l'oggetto Microsoft.Office.Interop.Excel.Worksheet sul quale si chiama questo metodo. Le chiamate successive a questo metodo sullo stesso oggetto Microsoft.Office.Interop.Excel.Worksheet restituiscono la stessa istanza Microsoft.Office.Tools.Excel.Worksheet.

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 worksheet è di tipo Microsoft.Office.Interop.Excel._Worksheet, che è l'interfaccia padre di Microsoft.Office.Interop.Excel.Worksheet.Pertanto, questo metodo estende i tipi Microsoft.Office.Interop.Excel._Worksheet e Microsoft.Office.Interop.Excel.Worksheet.In genere, quando si fa riferimento a un foglio di lavoro di Excel, si utilizza un oggetto Microsoft.Office.Interop.Excel.Worksheet.

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.