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

Article
05/16/2013

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

public static Worksheet GetVstoObject(
    this _Worksheet worksheet,
    ApplicationFactory factory
)

Paramètres

worksheet
Type : Microsoft.Office.Interop.Excel._Worksheet
Objet de feuille de calcul natif à étendre.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 : Microsoft.Office.Tools.Excel.Worksheet
Élément hôte qui étend les fonctionnalités de l'objet Microsoft.Office.Interop.Excel.Worksheet 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 _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, appelez cette méthode pour étendre toute feuille de calcul qui est ouverte dans Excel.Cette méthode génère un nouvel élément hôte Microsoft.Office.Tools.Excel.Worksheet si aucun objet n'a déjà été généré pour l'objet Microsoft.Office.Interop.Excel.Worksheet sur lequel vous appelez cette méthode.Les appels suivants à cette méthode sur le même objet Microsoft.Office.Interop.Excel.Worksheet retournent la même instance Microsoft.Office.Tools.Excel.Worksheet.

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