Método WorksheetExtensions.GetVstoObject (_Worksheet, ApplicationFactory)

Artigo
08/01/2011

Retorna um Microsoft.Office.Tools.Excel.Worksheet o item de host que estende a funcionalidade do atual Microsoft.Office.Interop.Excel.Worksheet o objeto em um nível de aplicativo add-in. Passar o Globals.Factory o objeto em seu projeto para o factory parâmetro.

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 de planilha nativo para estender.Não forneça esse parâmetro sozinho.Quando você chamar esse método em uma planilha do Excel, o runtime fornece esse parâmetro.

factory
Tipo: Microsoft.Office.Tools.Excel.ApplicationFactory
Um objeto que fornece acesso a recursos específicos do seu suplemento de nível de aplicativo.Passar o Globals.Factory o objeto para esse parâmetro.

Valor de retorno

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

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 TRANSLATION FROM VPE FOR CSHARP).

Comentários

Em um suplemento do nível de aplicativo, chame este método para estender a qualquer planilha que está aberta no Excel. Esse método gera um novo Microsoft.Office.Tools.Excel.Worksheet item de host, se não há tal objeto já foi gerado para o Microsoft.Office.Interop.Excel.Worksheet objeto no qual você chamar esse método. As chamadas subseqüentes a esse método no mesmo Microsoft.Office.Interop.Excel.Worksheet objeto retornar o mesmo Microsoft.Office.Tools.Excel.Worksheet instância.

Esse método é fornecido para compatibilidade com o escritório de projetos que você pode redirecionar da.NET Framework 3.5 para o .NET Framework 4. Em novos projetos destinados a .NET Framework 4, você deve chamar o GetVstoObject método fornecido pelo Globals.Factory objeto no seu projeto.

For more information, see 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 worksheet parâmetro é do tipo Microsoft.Office.Interop.Excel._Worksheet, que é a interface do pai do Microsoft.Office.Interop.Excel.Worksheet. Portanto, esse método amplia os dois tipos: Microsoft.Office.Interop.Excel._Worksheet and Microsoft.Office.Interop.Excel.Worksheet. Normalmente, quando você faz referência a uma planilha do Excel, você usa um Microsoft.Office.Interop.Excel.Worksheet.

O worksheet parâmetro é do tipo Microsoft.Office.Interop.Excel._Worksheet, que é a interface do pai do Microsoft.Office.Interop.Excel.Worksheet. Portanto, esse método amplia os dois tipos: Microsoft.Office.Interop.Excel._Worksheet and Microsoft.Office.Interop.Excel.Worksheet. Normalmente, quando você faz referência a uma planilha do Excel, você usa um 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.