Método WorksheetExtensions.HasVstoObject (_Worksheet, ApplicationFactory)

Artigo
05/21/2013

Retorna um valor que indica se um item de host de Microsoft.Office.Tools.Excel.Worksheet esteve criado para o 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 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 nativo a planilha para teste.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: System.Boolean
true se um item de host de Microsoft.Office.Tools.Excel.Worksheet foi criado para o objeto atual de Microsoft.Office.Interop.Excel.Worksheet ; 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 do C#).

Comentários

Em um suplemento ao aplicativo, você pode chamar esse método para determinar se um item de host de Microsoft.Office.Tools.Excel.Worksheet existe para qualquer objeto de Microsoft.Office.Interop.Excel.Worksheet .Normalmente, você usa esse método para testar a existência dos controles gerenciados que você deseja persistir antes de fechar ou de salvar uma planilha do excel.

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.