Método WorkbookExtensions.GetVstoObject (_Workbook, ApplicationFactory)

Retorna um item de host de Microsoft.Office.Tools.Excel.Workbook que estende a funcionalidade do objeto atual de Microsoft.Office.Interop.Excel.Workbook em um suplemento ao aplicativo.Passe o objeto de Globals.Factory em seu projeto para o parâmetro de factory .

Namespace: Microsoft.Office.Tools.Excel.Extensions
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintaxe

'Declaração
<ExtensionAttribute> _
Public Shared Function GetVstoObject ( _
    workbook As _Workbook, _
    factory As ApplicationFactory _
) As Workbook

public static Workbook GetVstoObject(
    this _Workbook workbook,
    ApplicationFactory factory
)

Parâmetros

workbook
Tipo: Microsoft.Office.Interop.Excel._Workbook
O objeto nativo de pasta de trabalho como estender.Não fornecer este parâmetro você mesmo.Quando você chamar esse método em uma pasta de trabalho do Excel, o tempo de execução fornece esse parâmetro.

factory
Tipo: Microsoft.Office.Tools.Excel.ApplicationFactory
Um objeto que fornece acesso a determinados recursos no suplemento ao aplicativo.Passe o objeto de Globals.Factory a esse parâmetro.

Valor de retorno

Tipo: Microsoft.Office.Tools.Excel.Workbook
Um item host que estende a funcionalidade do objeto atual de Microsoft.Office.Interop.Excel.Workbook .

Observação de uso

No Visual Basic e no C#, você pode chamar esse método como um método de instância em qualquer objeto do tipo _Workbook. Quando você usar a sintaxe de método de instância para chamar esse método, omita o primeiro parâmetro. Para obter mais informações, consulte Métodos de extensão (Visual Basic) ou Métodos de extensão (guia de programação do C#).

Comentários

Em um suplemento ao aplicativo, chamar esse método para estender qualquer pasta de trabalho do excel que é aberto.Este método gera um novo item host de Microsoft.Office.Tools.Excel.Workbook se nenhum tal objeto já foi gerado para o objeto de Microsoft.Office.Interop.Excel.Workbook em que você chamar esse método.Chamadas subsequentes a esse método no mesmo objeto de Microsoft.Office.Interop.Excel.Workbook retornam a mesma instância de Microsoft.Office.Tools.Excel.Workbook .

Este método é fornecida para compatibilidade com versões anteriores com o Office projetos que você retarget do .NET Framework 3.5 a .NET Framework 4 ou a .NET Framework 4.5.Nos novos projetos que destinam-se .NET Framework 4 ou .NET Framework 4.5, você deve chamar o método de GetVstoObject que é fornecido pelo objeto de Globals.Factory em seu projeto.

Para obter mais informações, consulte Estendendo os documentos do Word e pastas de trabalho do Excel em suplementos de nível de aplicativo em tempo de execução.

Observação
O parâmetro de workbook é do tipo Microsoft.Office.Interop.Excel._Workbook, que é a interface pai de Microsoft.Office.Interop.Excel.Workbook.Como consequência, este método estende os dois tipos: Microsoft.Office.Interop.Excel._Workbook e Microsoft.Office.Interop.Excel.Workbook.Normalmente, quando você referencia uma pasta de trabalho do Excel, você usa Microsoft.Office.Interop.Excel.Workbook.

O parâmetro de workbook é do tipo Microsoft.Office.Interop.Excel._Workbook, que é a interface pai de Microsoft.Office.Interop.Excel.Workbook.Como consequência, este método estende os dois tipos: Microsoft.Office.Interop.Excel._Workbook e Microsoft.Office.Interop.Excel.Workbook.Normalmente, quando você referencia uma pasta de trabalho do Excel, você usa Microsoft.Office.Interop.Excel.Workbook.

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.