Método WorksheetExtensions.GetVstoObject (_Worksheet, Factory)

Artigo
05/21/2013

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 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 ( _
    worksheet As _Worksheet, _
    factory As Factory _
) As Worksheet

public static Worksheet GetVstoObject(
    this _Worksheet worksheet,
    Factory 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.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.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

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.Worksheet que está na personalização atual.Se o objeto de Microsoft.Office.Interop.Excel.Worksheet em que você chamar este método não é o objeto subjacente de um item host de Microsoft.Office.Tools.Excel.Worksheet 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 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.