Método DocumentExtensions.HasVstoObject (_Document, ApplicationFactory)

Artigo
08/01/2011

Retorna um valor que indica se um Microsoft.Office.Tools.Word.Document o item de host foi criado para a atual Microsoft.Office.Interop.Word.Document 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.Word.Extensions
Assembly: Microsoft.Office.Tools.Word.v4.0.Utilities (em Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Sintaxe

'Declaração
<ExtensionAttribute> _
Public Shared Function HasVstoObject ( _
    document As _Document, _
    factory As ApplicationFactory _
) As Boolean

public static bool HasVstoObject(
    this _Document document,
    ApplicationFactory factory
)

Parâmetros

document
Tipo: Microsoft.Office.Interop.Word._Document
O objeto de documento nativo para testar.Não forneça esse parâmetro sozinho.Quando você chamar esse método em um documento do Word, o runtime fornece esse parâmetro.

factory
Tipo: Microsoft.Office.Tools.Word.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.Word.Document o item de host foi criado para a atual Microsoft.Office.Interop.Word.Document 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 _Document. 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.Word.Document o item de host existe para qualquer Microsoft.Office.Interop.Word.Document 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 um documento do Word.

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 Document parâmetro é do tipo Microsoft.Office.Interop.Word._Document, que é a interface do pai do Microsoft.Office.Interop.Word.Document. Portanto, esse método amplia os dois tipos: Microsoft.Office.Interop.Word._Document and Microsoft.Office.Interop.Word.Document. Normalmente, quando você faz referência a um documento do Word, você usa um Microsoft.Office.Interop.Word.Document.

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.