Metodo WorksheetExtensions.GetVstoObject (_Worksheet, Factory)

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 una personalizzazione a livello di documento. 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 Factory _
) As Worksheet

public static Worksheet GetVstoObject(
    this _Worksheet worksheet,
    Factory 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.Factory
Oggetto che fornisce accesso a funzionalità determinate nella personalizzazione a livello di documento.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 una personalizzazione a livello di documento, è possibile chiamare questo metodo per ottenere un elemento host Microsoft.Office.Tools.Excel.Worksheet che si trova nella personalizzazione corrente. Se l'oggetto Microsoft.Office.Interop.Excel.Worksheet sul quale si chiama questo metodo non è l'oggetto sottostante di un elemento host Microsoft.Office.Tools.Excel.Worksheet nella personalizzazione corrente, questo metodo restituisce nullriferimento null (Nothing in Visual Basic).

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 Programmazione delle personalizzazioni a livello di documento.

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.