WorkbookExtensions.HasVstoObject, méthode (_Workbook, ApplicationFactory)

Article
05/16/2013

Retourne une valeur qui indique si un élément hôte Microsoft.Office.Tools.Excel.Workbook a été créé pour l'objet Microsoft.Office.Interop.Excel.Workbook 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 ( _
    workbook As _Workbook, _
    factory As ApplicationFactory _
) As Boolean

public static bool HasVstoObject(
    this _Workbook workbook,
    ApplicationFactory factory
)

Paramètres

workbook
Type : Microsoft.Office.Interop.Excel._Workbook
Objet de classeur natif à tester.Ne fournissez pas ce paramètre vous-même.Lorsque vous appelez cette méthode dans un classeur 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.Workbook a été créé pour l'objet Microsoft.Office.Interop.Excel.Workbook 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 _Workbook. 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.Workbook existe pour un objet Microsoft.Office.Interop.Excel.Workbook.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 un classeur 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 Workbook est de type Microsoft.Office.Interop.Excel._Workbook, ce qui correspond à l'interface parente de Microsoft.Office.Interop.Excel.Workbook.Par conséquent, cette méthode étend à la fois les types Microsoft.Office.Interop.Excel._Workbook et Microsoft.Office.Interop.Excel.Workbook.En général, lorsque vous référencez un classeur Excel, vous utilisez Microsoft.Office.Interop.Excel.Workbook.

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.