Compartilhar via

WorksheetExtensions.GetVstoObject Método

  • Referência

Definição

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

Sobrecargas

GetVstoObject(_Worksheet, ApplicationFactory)

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

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

GetVstoObject(_Worksheet, ApplicationFactory)

Retorna um item de host Worksheet que estende a funcionalidade do objeto Worksheet 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::Worksheet ^ GetVstoObject(Microsoft::Office::Interop::Excel::_Worksheet ^ worksheet, Microsoft::Office::Tools::Excel::ApplicationFactory ^ factory);
public static Microsoft.Office.Tools.Excel.Worksheet GetVstoObject (this Microsoft.Office.Interop.Excel._Worksheet worksheet, Microsoft.Office.Tools.Excel.ApplicationFactory factory);
static member GetVstoObject : Microsoft.Office.Interop.Excel._Worksheet * Microsoft.Office.Tools.Excel.ApplicationFactory -> Microsoft.Office.Tools.Excel.Worksheet
<Extension()>
Public Function GetVstoObject (worksheet As _Worksheet, factory As ApplicationFactory) As Worksheet

Parâmetros

worksheet
_Worksheet

O objeto de planilha nativo a ser estendido. Não forneça esse parâmetro. Quando você chama esse método em uma planilha 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

Worksheet

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

Comentários

Em um suplemento no nível do aplicativo, chame esse método para estender qualquer planilha que esteja aberta no Excel. Esse método gerará um novo Microsoft.Office.Tools.Excel.Worksheet item de host se nenhum objeto desse tipo já tiver sido gerado para o Microsoft.Office.Interop.Excel.Worksheet objeto no qual você chama esse método. Chamadas subsequentes para esse método no mesmo Microsoft.Office.Interop.Excel.Worksheet objeto retornam a mesma Microsoft.Office.Tools.Excel.Worksheet 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 worksheet é do tipo Microsoft.Office.Interop.Excel._Worksheet, que é a interface pai de Microsoft.Office.Interop.Excel.Worksheet. Por isso, esse método estende ambos os tipos: Microsoft.Office.Interop.Excel._Worksheet e Microsoft.Office.Interop.Excel.Worksheet. Normalmente, ao referenciar uma planilha do Excel, você usa um Microsoft.Office.Interop.Excel.Worksheet.

Aplica-se a

GetVstoObject(_Worksheet, Factory)

Retorna um item de host Worksheet que estende a funcionalidade do objeto Worksheet 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::Worksheet ^ GetVstoObject(Microsoft::Office::Interop::Excel::_Worksheet ^ worksheet, Microsoft::Office::Tools::Excel::Factory ^ factory);
public static Microsoft.Office.Tools.Excel.Worksheet GetVstoObject (this Microsoft.Office.Interop.Excel._Worksheet worksheet, Microsoft.Office.Tools.Excel.Factory factory);
static member GetVstoObject : Microsoft.Office.Interop.Excel._Worksheet * Microsoft.Office.Tools.Excel.Factory -> Microsoft.Office.Tools.Excel.Worksheet
<Extension()>
Public Function GetVstoObject (worksheet As _Worksheet, factory As Factory) As Worksheet

Parâmetros

worksheet
_Worksheet

O objeto de planilha nativo a ser estendido. Não forneça esse parâmetro. Quando você chama esse método em uma planilha 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

Worksheet

Um item de host que estende a funcionalidade do objeto Worksheet 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.Worksheet item de host que esteja na personalização atual. Se o Microsoft.Office.Interop.Excel.Worksheet objeto no qual você chama esse método não for o objeto subjacente de um Microsoft.Office.Tools.Excel.Worksheet 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 worksheet é do tipo Microsoft.Office.Interop.Excel._Worksheet, que é a interface pai de Microsoft.Office.Interop.Excel.Worksheet. Por isso, esse método estende ambos os tipos: Microsoft.Office.Interop.Excel._Worksheet e Microsoft.Office.Interop.Excel.Worksheet. Normalmente, ao referenciar uma planilha do Excel, você usa um Microsoft.Office.Interop.Excel.Worksheet.

Aplica-se a