Método WorkbookExtensions.GetVstoObject (_Workbook, Factory)

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 uma personalização da nível.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 Factory _
) As Workbook

public static Workbook GetVstoObject(
    this _Workbook workbook,
    Factory 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.Factory
Um objeto que fornece acesso a determinados recursos em sua personalização da nível.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

Personalização de um documento em um nível, você pode chamar esse método para obter um item de host de Microsoft.Office.Tools.Excel.Workbook que está na personalização atual.Se o objeto de Microsoft.Office.Interop.Excel.Workbook em que você chamar este método não é o objeto subjacente de um item host de Microsoft.Office.Tools.Excel.Workbook a personalização atual, retorna nulluma referência nula (Nothing no Visual Basic)desse método.

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 Programação personalizações em nível de documento.

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.