WorkbookExtensions.GetVstoObject Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
GetVstoObject(_Workbook, ApplicationFactory) |
Devuelve un elemento host Workbook que extiende las funciones del objeto Workbook actual en un complemento en el nivel de la aplicación. Pase el objeto Globals.Factory de su proyecto al parámetro |
GetVstoObject(_Workbook, Factory) |
Devuelve un elemento host Workbook que extiende las funciones del objeto Workbook actual en una personalización de nivel de documento. Pase el objeto Globals.Factory de su proyecto al parámetro |
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
Parámetros
- workbook
- _Workbook
El objeto de libro nativo que se va a extender. No proporcione este parámetro personalmente. Cuando llame a este método en un libro de Excel, el tiempo de ejecución proporciona este parámetro.
- factory
- ApplicationFactory
Un objeto que proporciona acceso a determinadas características en su complemento en el nivel de la aplicación. Pase el objeto Globals.Factory
a este parámetro.
Devoluciones
Un elemento host que extiende las funciones del objeto Workbook actual.
Comentarios
En un complemento de nivel de aplicación, llame a este método para extender cualquier libro que esté abierto en Excel. Este método genera un nuevo Microsoft.Office.Tools.Excel.Workbook elemento host si no se ha generado ningún objeto para el objeto en el Microsoft.Office.Interop.Excel.Workbook que se llama a este método. Las llamadas posteriores a este método en el mismo Microsoft.Office.Interop.Excel.Workbook objeto devuelven la misma Microsoft.Office.Tools.Excel.Workbook instancia.
Este método se proporciona para la compatibilidad con versiones anteriores con proyectos de Office que se vuelven a cambiar de .NET Framework 3.5 a .NET Framework 4 o .NET Framework 4.5. En proyectos nuevos que tienen como destino .NET Framework 4 o .NET Framework 4.5, debe llamar al GetVstoObject
método proporcionado por el objeto en el Globals.Factory
proyecto.
Para obtener más información, consulta Extending Word Documents and Excel Workbooks in VSTO Add-ins at Run Time.
Nota
El workbook
parámetro es de tipo Microsoft.Office.Interop.Excel._Workbook, que es la interfaz primaria de Microsoft.Office.Interop.Excel.Workbook. Por lo tanto, este método extiende ambos tipos: Microsoft.Office.Interop.Excel._Workbook y Microsoft.Office.Interop.Excel.Workbook. Normalmente, cuando se hace referencia a un libro de Excel, se usa .Microsoft.Office.Interop.Excel.Workbook
Se aplica a
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
Parámetros
- workbook
- _Workbook
El objeto de libro nativo que se va a extender. No proporcione este parámetro personalmente. Cuando llame a este método en un libro de Excel, el tiempo de ejecución proporciona este parámetro.
- factory
- Factory
Un objeto que proporciona acceso a determinadas características en su personalización de nivel de documento. Pase el objeto Globals.Factory
a este parámetro.
Devoluciones
Un elemento host que extiende las funciones del objeto Workbook actual.
Comentarios
En una personalización de nivel de documento, puede llamar a este método para obtener un Microsoft.Office.Tools.Excel.Workbook elemento host que se encuentra en la personalización actual. Si el Microsoft.Office.Interop.Excel.Workbook objeto en el que se llama a este método no es el objeto subyacente de un Microsoft.Office.Tools.Excel.Workbook elemento host en la personalización actual, este método devuelve null
.
Este método se proporciona para la compatibilidad con versiones anteriores con proyectos de Office que se vuelven a cambiar de .NET Framework 3.5 a .NET Framework 4 o .NET Framework 4.5. En proyectos nuevos que tienen como destino .NET Framework 4 o .NET Framework 4.5, debe llamar al GetVstoObject
método proporcionado por el objeto en el Globals.Factory
proyecto. Para obtener más información, consulta Programming Document-Level Customizations.
Nota
El workbook
parámetro es de tipo Microsoft.Office.Interop.Excel._Workbook, que es la interfaz primaria de Microsoft.Office.Interop.Excel.Workbook. Por lo tanto, este método extiende ambos tipos: Microsoft.Office.Interop.Excel._Workbook y Microsoft.Office.Interop.Excel.Workbook. Normalmente, cuando se hace referencia a un libro de Excel, se usa .Microsoft.Office.Interop.Excel.Workbook