Metodo WorksheetExtensions.HasVstoObject (_Worksheet, ApplicationFactory)

Articolo
01/06/2014

Restituisce un valore che indica se è stato creato un elemento host Microsoft.Office.Tools.Excel.Worksheet per l'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 HasVstoObject ( _
    worksheet As _Worksheet, _
    factory As ApplicationFactory _
) As Boolean

public static bool HasVstoObject(
    this _Worksheet worksheet,
    ApplicationFactory factory
)

Parametri

worksheet
Tipo: Microsoft.Office.Interop.Excel._Worksheet
Oggetto foglio di lavoro nativo da testare.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: System.Boolean
true se è stato creato un elemento host Microsoft.Office.Tools.Excel.Worksheet per l'oggetto Microsoft.Office.Interop.Excel.Worksheet corrente; in caso contrario, false.

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, è possibile chiamare questo metodo per determinare se un elemento host Microsoft.Office.Tools.Excel.Worksheet esiste per qualsiasi oggetto Microsoft.Office.Interop.Excel.Worksheet. In genere questo metodo viene utilizzato per testare l'esistenza di controlli gestiti che si desidera salvare in modo permanente prima di chiudere o salvare un foglio di lavoro di Excel.

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.