Método DocumentExtensions.GetVstoObject (_Document, ApplicationFactory)

Artigo
08/01/2011

Retorna um Microsoft.Office.Tools.Word.Document o item de host que estende a funcionalidade do 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 GetVstoObject ( _
    document As _Document, _
    factory As ApplicationFactory _
) As Document

public static Document GetVstoObject(
    this _Document document,
    ApplicationFactory factory
)

Parâmetros

document
Tipo: Microsoft.Office.Interop.Word._Document
O objeto de documento nativo para estender.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: Microsoft.Office.Tools.Word.Document
Um item de host que estende a funcionalidade do atual Microsoft.Office.Interop.Word.Document 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 _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, chame este método para estender a qualquer documento que está aberto no Word. Esse método gera um novo Microsoft.Office.Tools.Word.Document item de host, se não há tal objeto já foi gerado para o Microsoft.Office.Interop.Word.Document objeto no qual você chamar esse método. As chamadas subseqüentes a esse método no mesmo Microsoft.Office.Interop.Word.Document objeto retornar o mesmo Microsoft.Office.Tools.Word.Document 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 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.