Método WorksheetExtensions.GetVstoObject (_Worksheet, ApplicationFactory)

Retorna um item de host de Microsoft.Office.Tools.Excel.Worksheet que estende a funcionalidade do objeto atual de Microsoft.Office.Interop.Excel.Worksheet 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 ( _
    worksheet As _Worksheet, _
    factory As ApplicationFactory _
) As Worksheet

public static Worksheet GetVstoObject(
    this _Worksheet worksheet,
    ApplicationFactory factory
)

Parâmetros

worksheet
Tipo: Microsoft.Office.Interop.Excel._Worksheet
O objeto nativo da planilha estender.Não fornecer este parâmetro você mesmo.Quando você chamar esse método em uma planilha 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.Worksheet
Um item host que estende a funcionalidade do objeto atual de Microsoft.Office.Interop.Excel.Worksheet .

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 _Worksheet. 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 planilha do excel que é aberto.Este método gera um novo item host de Microsoft.Office.Tools.Excel.Worksheet se nenhum tal objeto já foi gerado para o objeto de Microsoft.Office.Interop.Excel.Worksheet em que você chamar esse método.Chamadas subsequentes a esse método no mesmo objeto de Microsoft.Office.Interop.Excel.Worksheet retornam a mesma instância de Microsoft.Office.Tools.Excel.Worksheet .

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 worksheet é do tipo Microsoft.Office.Interop.Excel._Worksheet, que é a interface pai de Microsoft.Office.Interop.Excel.Worksheet.Como consequência, este método estende os dois tipos: Microsoft.Office.Interop.Excel._Worksheet e Microsoft.Office.Interop.Excel.Worksheet.Normalmente, quando você referencia uma planilha do excel, você usa Microsoft.Office.Interop.Excel.Worksheet.

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.