Método WorksheetExtensions.HasVstoObject (_Worksheet, ApplicationFactory)

Artigo
08/01/2011

Retorna um valor que indica se um Microsoft.Office.Tools.Excel.Worksheet o item de host foi criado para a 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 HasVstoObject ( _
    worksheet As _Worksheet, _
    factory As ApplicationFactory _
) As Boolean

public static bool HasVstoObject(
    this _Worksheet worksheet,
    ApplicationFactory factory
)

Parâmetros

worksheet
Tipo: Microsoft.Office.Interop.Excel._Worksheet
O objeto de planilha nativo para testar.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: System.Boolean
true Se um Microsoft.Office.Tools.Excel.Worksheet o item de host foi criado para a atual Microsoft.Office.Interop.Excel.Worksheet objeto; Caso contrário, false.

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, você pode chamar esse método para determinar se um Microsoft.Office.Tools.Excel.Worksheet o item de host existe para qualquer Microsoft.Office.Interop.Excel.Worksheet objeto. Normalmente, você deve usar esse método para testar a existência de controles gerenciados que você deseja manter antes de fechar ou salvar uma planilha do Excel.

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.