Compartilhar via

WorkbookExtensions.GetVstoObject Método

  • Referência

Definição

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

Sobrecargas

GetVstoObject(_Workbook, ApplicationFactory)

Retorna um item de host Workbook que estende a funcionalidade do objeto Workbook atual em um suplemento no nível de aplicativo. Passe o objeto Globals.Factory do projeto para o parâmetro factory.
GetVstoObject(_Workbook, Factory)

Retorna um item de host Workbook que estende a funcionalidade do objeto Workbook atual em uma personalização no nível de documento. Passe o objeto Globals.Factory do projeto para o parâmetro factory.

GetVstoObject(_Workbook, ApplicationFactory)

Retorna um item de host Workbook que estende a funcionalidade do objeto Workbook atual em um suplemento no nível de aplicativo. Passe o objeto Globals.Factory do projeto para o parâmetro factory.

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

O objeto de pasta de trabalho nativo a ser estendido. Não forneça esse parâmetro. Quando você chama esse método em uma pasta de trabalho do Excel, o runtime fornece esse parâmetro.

factory
ApplicationFactory

Um objeto que dá acesso a determinados recursos no suplemento no nível de aplicativo. Passe o objeto Globals.Factory para esse parâmetro.

Retornos

Workbook

Um item de host que estende a funcionalidade do objeto Workbook atual.

Comentários

Em um suplemento no nível do aplicativo, chame esse método para estender qualquer pasta de trabalho que esteja aberta no Excel. Esse método gerará um novo Microsoft.Office.Tools.Excel.Workbook item de host se nenhum objeto desse tipo já tiver sido gerado para o Microsoft.Office.Interop.Excel.Workbook objeto no qual você chama esse método. Chamadas subsequentes para esse método no mesmo Microsoft.Office.Interop.Excel.Workbook objeto retornam a mesma Microsoft.Office.Tools.Excel.Workbook instância.

Esse método é fornecido para compatibilidade com versões anteriores com projetos do Office que você redireciona do .NET Framework 3.5 para o .NET Framework 4 ou o .NET Framework 4.5. Em novos projetos direcionados ao .NET Framework 4 ou ao .NET Framework 4.5, você deve chamar o GetVstoObject método fornecido pelo Globals.Factory objeto em seu projeto.

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

Observação

O parâmetro workbook é do tipo Microsoft.Office.Interop.Excel._Workbook, que é a interface pai de Microsoft.Office.Interop.Excel.Workbook. Por isso, esse método estende ambos os tipos: Microsoft.Office.Interop.Excel._Workbook e Microsoft.Office.Interop.Excel.Workbook. Normalmente, ao referenciar uma pasta de trabalho do Excel, você usa um Microsoft.Office.Interop.Excel.Workbook.

Aplica-se a

GetVstoObject(_Workbook, Factory)

Retorna um item de host Workbook que estende a funcionalidade do objeto Workbook atual em uma personalização no nível de documento. Passe o objeto Globals.Factory do projeto para o parâmetro 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

O objeto de pasta de trabalho nativo a ser estendido. Não forneça esse parâmetro. Quando você chama esse método em uma pasta de trabalho do Excel, o runtime fornece esse parâmetro.

factory
Factory

Um objeto que dá acesso a determinados recursos na personalização no nível de documento. Passe o objeto Globals.Factory para esse parâmetro.

Retornos

Workbook

Um item de host que estende a funcionalidade do objeto Workbook atual.

Comentários

Em uma personalização no nível do documento, você pode chamar esse método para obter um Microsoft.Office.Tools.Excel.Workbook item de host que esteja na personalização atual. Se o Microsoft.Office.Interop.Excel.Workbook objeto no qual você chama esse método não for o objeto subjacente de um Microsoft.Office.Tools.Excel.Workbook item de host na personalização atual, esse método retornará null.

Esse método é fornecido para compatibilidade com versões anteriores com projetos do Office que você redireciona do .NET Framework 3.5 para o .NET Framework 4 ou o .NET Framework 4.5. Em novos projetos direcionados ao .NET Framework 4 ou ao .NET Framework 4.5, você deve chamar o GetVstoObject método fornecido pelo Globals.Factory objeto em seu projeto. Para obter mais informações, consulte Programação Document-Level personalizações.

Observação

O parâmetro workbook é do tipo Microsoft.Office.Interop.Excel._Workbook, que é a interface pai de Microsoft.Office.Interop.Excel.Workbook. Por isso, esse método estende ambos os tipos: Microsoft.Office.Interop.Excel._Workbook e Microsoft.Office.Interop.Excel.Workbook. Normalmente, ao referenciar uma pasta de trabalho do Excel, você usa um Microsoft.Office.Interop.Excel.Workbook.

Aplica-se a