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

Article
05/16/2013

Retourne un élément hôte Microsoft.Office.Tools.Excel.Workbook qui étend les fonctionnalités de 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 GetVstoObject ( _
    workbook As _Workbook, _
    factory As ApplicationFactory _
) As Workbook

public static Workbook GetVstoObject(
    this _Workbook workbook,
    ApplicationFactory factory
)

Paramètres

workbook
Type : Microsoft.Office.Interop.Excel._Workbook
Objet de classeur natif à étendre.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 : Microsoft.Office.Tools.Excel.Workbook
Élément hôte qui étend les fonctionnalités de l'objet Microsoft.Office.Interop.Excel.Workbook actuel.

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, appelez cette méthode pour étendre tout classeur qui est ouvert dans Excel.Cette méthode génère un nouvel élément hôte Microsoft.Office.Tools.Excel.Workbook si aucun objet n'a déjà été généré pour l'objet Microsoft.Office.Interop.Excel.Workbook sur lequel vous appelez cette méthode.Les appels suivants à cette méthode sur le même objet Microsoft.Office.Interop.Excel.Workbook retournent la même instance Microsoft.Office.Tools.Excel.Workbook.

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, 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.