WorkbookExtensions.GetVstoObject Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
GetVstoObject(_Workbook, ApplicationFactory) |
Retourne un élément hôte Workbook qui étend les fonctionnalités de l’objet Workbook actuel dans un complément de niveau application. Transmettez l’objet Globals.Factory de votre projet au paramètre |
GetVstoObject(_Workbook, Factory) |
Retourne un élément hôte Workbook qui étend les fonctionnalités de l’objet Workbook actuel dans une personnalisation au niveau du document. Transmettez l’objet Globals.Factory de votre projet au paramètre |
GetVstoObject(_Workbook, ApplicationFactory)
public:
[System::Runtime::CompilerServices::Extension]
static Microsoft::Office::Tools::Excel::Workbook ^ GetVstoObject(Microsoft::Office::Interop::Excel::_Workbook ^ workbook, Microsoft::Office::Tools::Excel::ApplicationFactory ^ factory);
public static Microsoft.Office.Tools.Excel.Workbook GetVstoObject (this Microsoft.Office.Interop.Excel._Workbook workbook, Microsoft.Office.Tools.Excel.ApplicationFactory factory);
static member GetVstoObject : Microsoft.Office.Interop.Excel._Workbook * Microsoft.Office.Tools.Excel.ApplicationFactory -> Microsoft.Office.Tools.Excel.Workbook
<Extension()>
Public Function GetVstoObject (workbook As _Workbook, factory As ApplicationFactory) As Workbook
Paramètres
- workbook
- _Workbook
Objet classeur natif à étendre. Ne spécifiez pas ce paramètre vous-même. Si vous appelez cette méthode dans un classeur Excel, le runtime fournit ce paramètre.
- factory
- ApplicationFactory
Objet qui fournit l’accès à certaines fonctionnalités de votre complément de niveau application. Transmettez l’objet Globals.Factory
à ce paramètre.
Retours
Élément hôte qui étend les fonctionnalités de l’objet Workbook actuel.
Remarques
Dans un complément au niveau de l’application, appelez cette méthode pour étendre tout classeur ouvert dans Excel. Cette méthode génère un nouvel Microsoft.Office.Tools.Excel.Workbook élément hôte si aucun objet de ce type 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 Microsoft.Office.Interop.Excel.Workbook objet retournent le même Microsoft.Office.Tools.Excel.Workbook instance.
Cette méthode est fournie pour la compatibilité descendante avec les projets Office que vous reciblez à partir du .NET Framework 3.5 vers .NET Framework 4 ou .NET Framework 4.5. Dans les nouveaux projets qui ciblent .NET Framework 4 ou .NET Framework 4.5, vous devez appeler la GetVstoObject
méthode fournie par l’objet Globals.Factory
dans votre projet.
Pour plus d'informations, consultez Extending Word Documents and Excel Workbooks in VSTO Add-ins at Run Time.
Notes
Le workbook
paramètre est de type Microsoft.Office.Interop.Excel._Workbook, qui est l’interface parente de Microsoft.Office.Interop.Excel.Workbook. Par conséquent, cette méthode étend les deux types : Microsoft.Office.Interop.Excel._Workbook et Microsoft.Office.Interop.Excel.Workbook. En règle générale, lorsque vous référencez un classeur Excel, vous utilisez un Microsoft.Office.Interop.Excel.Workbook.
S’applique à
GetVstoObject(_Workbook, Factory)
public:
[System::Runtime::CompilerServices::Extension]
static Microsoft::Office::Tools::Excel::Workbook ^ GetVstoObject(Microsoft::Office::Interop::Excel::_Workbook ^ workbook, Microsoft::Office::Tools::Excel::Factory ^ factory);
public static Microsoft.Office.Tools.Excel.Workbook GetVstoObject (this Microsoft.Office.Interop.Excel._Workbook workbook, Microsoft.Office.Tools.Excel.Factory factory);
static member GetVstoObject : Microsoft.Office.Interop.Excel._Workbook * Microsoft.Office.Tools.Excel.Factory -> Microsoft.Office.Tools.Excel.Workbook
<Extension()>
Public Function GetVstoObject (workbook As _Workbook, factory As Factory) As Workbook
Paramètres
- workbook
- _Workbook
Objet classeur natif à étendre. Ne spécifiez pas ce paramètre vous-même. Si vous appelez cette méthode dans un classeur Excel, le runtime fournit ce paramètre.
- factory
- Factory
Objet qui fournit l’accès à certaines fonctionnalités de votre personnalisation au niveau du document. Transmettez l’objet Globals.Factory
à ce paramètre.
Retours
Élément hôte qui étend les fonctionnalités de l’objet Workbook actuel.
Remarques
Dans une personnalisation au niveau du document, vous pouvez appeler cette méthode pour obtenir un Microsoft.Office.Tools.Excel.Workbook élément hôte qui se trouve dans la personnalisation actuelle. Si l’objet Microsoft.Office.Interop.Excel.Workbook sur lequel vous appelez cette méthode n’est pas l’objet sous-jacent d’un Microsoft.Office.Tools.Excel.Workbook élément hôte dans la personnalisation actuelle, cette méthode retourne null
.
Cette méthode est fournie pour la compatibilité descendante avec les projets Office que vous reciblez à partir du .NET Framework 3.5 vers .NET Framework 4 ou .NET Framework 4.5. Dans les nouveaux projets qui ciblent .NET Framework 4 ou .NET Framework 4.5, vous devez appeler la GetVstoObject
méthode fournie par l’objet Globals.Factory
dans votre projet. Pour plus d'informations, consultez Programming Document-Level Customizations.
Notes
Le workbook
paramètre est de type Microsoft.Office.Interop.Excel._Workbook, qui est l’interface parente de Microsoft.Office.Interop.Excel.Workbook. Par conséquent, cette méthode étend les deux types : Microsoft.Office.Interop.Excel._Workbook et Microsoft.Office.Interop.Excel.Workbook. En règle générale, lorsque vous référencez un classeur Excel, vous utilisez un Microsoft.Office.Interop.Excel.Workbook.