ApplicationFactory.GetVstoObject (Método) (_Workbook)

Artículo
05/15/2013

Devuelve un elemento host Microsoft.Office.Tools.Excel.Workbook que extiende la funcionalidad del objeto de libro nativo especificado.

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

Sintaxis

'Declaración
Function GetVstoObject ( _
    workbook As _Workbook _
) As Workbook

Workbook GetVstoObject(
    _Workbook workbook
)

Parámetros

workbook
Tipo: Microsoft.Office.Interop.Excel._Workbook
Objeto de libro nativo para el que se va a recuperar el objeto extendido.Aunque este parámetro es de tipo Microsoft.Office.Interop.Excel._Workbook, normalmente se pasa un objeto Microsoft.Office.Interop.Excel.Workbook a este método.

Valor devuelto

Tipo: Microsoft.Office.Tools.Excel.Workbook
Elemento host que extiende la funcionalidad del objeto de libro nativo.

Comentarios

Llame a este método en un complemento en el nivel de la aplicación para personalizar cualquier libro que esté abierto en Excel.Este método genera un nuevo objeto Microsoft.Office.Tools.Excel.Workbook si aún no se ha generado ninguno.Llamadas subsiguientes a este método devuelven la instancia almacenada en memoria caché del objeto Microsoft.Office.Tools.Excel.Workbook existente.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 workbook es de tipo Microsoft.Office.Interop.Excel._Workbook, que es la interfaz primaria de Microsoft.Office.Interop.Excel.Workbook.Por consiguiente, este método puede aceptar objetos de ambos tipos: Microsoft.Office.Interop.Excel._Workbook y Microsoft.Office.Interop.Excel.Workbook.Normalmente, al hacer referencia a un libro de Excel, se usa un Microsoft.Office.Interop.Excel.Workbook.

Ejemplos

En el ejemplo de código siguiente se crea un elemento host Microsoft.Office.Tools.Excel.Workbook para el libro de Excel activo.Para utilizar este código, ejecútelo desde la clase de ThisAddIn en un proyecto de complemento de Excel destinado a .NET Framework 4 o .NET Framework 4.5.

Dim vstoWorkbook As Workbook = _
    Globals.Factory.GetVstoObject(Me.Application.ActiveWorkbook)

For Each st As SmartTag In vstoWorkbook.VstoSmartTags
    System.Windows.Forms.MessageBox.Show(st.Caption)
Next

Workbook vstoWorkbook =
    Globals.Factory.GetVstoObject(this.Application.ActiveWorkbook);

foreach (SmartTag st in vstoWorkbook.VstoSmartTags)
{
    System.Windows.Forms.MessageBox.Show(st.Caption);
}

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.