WorksheetExtensions.HasVstoObject, méthode (_Worksheet, ApplicationFactory)

Article
05/16/2013

Retourne une valeur qui indique si un élément hôte Microsoft.Office.Tools.Excel.Worksheet a été créé pour l'objet Microsoft.Office.Interop.Excel.Worksheet actuel dans un complément d'application.Passe l'objet Globals.Factory de votre projet au paramètre factory.

Espace de noms : Microsoft.Office.Tools.Excel.Extensions
Assembly : Microsoft.Office.Tools.Excel.v4.0.Utilities (dans Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntaxe

'Déclaration
<ExtensionAttribute> _
Public Shared Function HasVstoObject ( _
    worksheet As _Worksheet, _
    factory As ApplicationFactory _
) As Boolean

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

Paramètres

worksheet
Type : Microsoft.Office.Interop.Excel._Worksheet
Objet de feuille de calcul natif à tester.Ne fournissez pas ce paramètre vous-même.Lorsque vous appelez cette méthode dans une feuille de calcul Excel, le runtime fournit ce paramètre.

factory
Type : Microsoft.Office.Tools.Excel.ApplicationFactory
Objet qui permet l'accès à certaines fonctionnalités de votre complément d'application.Passe l'objet Globals.Factory à passer à ce paramètre.

Valeur de retour

Type : System.Boolean
true si un élément hôte Microsoft.Office.Tools.Excel.Worksheet a été créé pour l'objet Microsoft.Office.Interop.Excel.Worksheet actuel ; sinon, false.

Remarque sur l'utilisation

En Visual Basic et C#, vous pouvez appeler cette méthode comme une méthode d'instance sur n'importe quel objet de type _Worksheet. Lorsque vous utilisez la syntaxe des méthodes d'instance pour appeler cette méthode, omettez le premier paramètre. Pour plus d'informations, consultez Méthodes d'extension (Visual Basic) ou Méthodes d'extension (Guide de programmation C#).

Notes

Dans un complément d'application, vous pouvez appeler cette méthode pour déterminer si un élément hôte Microsoft.Office.Tools.Excel.Worksheet existe pour un objet Microsoft.Office.Interop.Excel.Worksheet.En général, vous utilisez cette méthode pour tester l'existence de contrôles managés que vous voulez rendre persistants avant de fermer ou d'enregistrer une feuille de calcul Excel.

Cette méthode est fournie pour la compatibilité descendante avec les projets Office que vous reciblez le .NET Framework 3.5 à .NET Framework 4 ou à .NET Framework 4.5.Dans les projets qui ciblent .NET Framework 4 ou .NET Framework 4.5, vous devez appeler la méthode d' GetVstoObject fournie par l'objet d' Globals.Factory dans votre projet.Pour plus d'informations, consultez Extension de documents Word et de classeurs Excel dans des compléments d'application au moment de l'exécution..

[!REMARQUE]

Le paramètre Worksheet est de type Microsoft.Office.Interop.Excel._Worksheet, ce qui correspond à l'interface parente de Microsoft.Office.Interop.Excel.Worksheet.Par conséquent, cette méthode étend à la fois les types Microsoft.Office.Interop.Excel._Worksheet et Microsoft.Office.Interop.Excel.Worksheet.En général, lorsque vous référencez une feuille de calcul Excel, vous utilisez Microsoft.Office.Interop.Excel.Worksheet.

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.