WorksheetExtensions.GetVstoObject (Método) (_Worksheet, ApplicationFactory)

Devuelve un elemento host Microsoft.Office.Tools.Excel.Worksheet que extiende la funcionalidad del objeto Microsoft.Office.Interop.Excel.Worksheet actual en un complemento del nivel de aplicación.Pasa el objeto Globals.Factory del proyecto al parámetro factory.

Espacio de nombres: Microsoft.Office.Tools.Excel.Extensions
Ensamblado: Microsoft.Office.Tools.Excel.v4.0.Utilities (en Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintaxis

'Declaración
<ExtensionAttribute> _
Public Shared Function GetVstoObject ( _
    worksheet As _Worksheet, _
    factory As ApplicationFactory _
) As Worksheet

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

Parámetros

worksheet
Tipo: Microsoft.Office.Interop.Excel._Worksheet
Objeto de hoja de cálculo nativo que se va a extender.No proporcione este parámetro personalmente.Al llamar a este método en una hoja de cálculo de Excel, el motor en tiempo de ejecución proporciona este parámetro.

factory
Tipo: Microsoft.Office.Tools.Excel.ApplicationFactory
Objeto que proporciona acceso a determinadas características del complemento del nivel de la aplicación.Pasa el objeto Globals.Factory a este parámetro.

Valor devuelto

Tipo: Microsoft.Office.Tools.Excel.Worksheet
Elemento host que extiende la funcionalidad del objeto Microsoft.Office.Interop.Excel.Worksheet actual.

Nota sobre el uso

En Visual Basic y C#, se puede llamar a este método como a un método de instancia en cualquier objeto de tipo _Worksheet. Cuando emplee la sintaxis del método de instancia para llamar a este método, omita el primer parámetro. Para obtener más información, vea Métodos de extensión (Visual Basic) o Métodos de extensión (Guía de programación de C#).

Comentarios

Llame a este método en un complemento en el nivel de la aplicación para extender cualquier hoja de cálculo que esté abierta en Excel.Este método genera un nuevo elemento host Microsoft.Office.Tools.Excel.Worksheet si aún no se ha generado para el objeto Microsoft.Office.Interop.Excel.Worksheet en el que llama a este método.Llamadas subsiguientes a este método en el mismo objeto Microsoft.Office.Interop.Excel.Worksheet devuelven la misma instancia Microsoft.Office.Tools.Excel.Worksheet.

Este método se proporciona para la compatibilidad con versiones anteriores de Office destinados a cambia de .NET Framework 3.5 a .NET Framework 4 o a .NET Framework 4.5.En los nuevos proyectos destinados .NET Framework 4 o .NET Framework 4.5, debe llamar al método de GetVstoObject proporcionado por el objeto de Globals.Factory en el proyecto.

Para obtener más información, vea Ampliar documentos de Word y libros de Excel en complementos en el nivel de la aplicación en tiempo de ejecución.

[!NOTA]

El parámetro worksheet es de tipo Microsoft.Office.Interop.Excel._Worksheet, que es la interfaz primaria de Microsoft.Office.Interop.Excel.Worksheet.Por consiguiente, este método extiende ambos tipos: Microsoft.Office.Interop.Excel._Worksheet y Microsoft.Office.Interop.Excel.Worksheet.Normalmente, al hacer referencia a una hoja de cálculo de Excel, se usa un Microsoft.Office.Interop.Excel.Worksheet.

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.