Metodo DocumentExtensions.GetVstoObject (_Document, ApplicationFactory)

Restituisce un elemento host Microsoft.Office.Tools.Word.Document che estende la funzionalità dell'oggetto Microsoft.Office.Interop.Word.Document corrente in un componente aggiuntivo a livello di applicazione. Passa l'oggetto Globals.Factory nel progetto nel parametro factory.

Spazio dei nomi: Microsoft.Office.Tools.Word.Extensions
Assembly: Microsoft.Office.Tools.Word.v4.0.Utilities (in Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Sintassi

'Dichiarazione
<ExtensionAttribute> _
Public Shared Function GetVstoObject ( _
    document As _Document, _
    factory As ApplicationFactory _
) As Document

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

Parametri

document
Tipo: Microsoft.Office.Interop.Word._Document
Oggetto documento nativo da estendere.Non fornire questo parametro.Quando si chiama questo metodo su un documento di Word, il runtime fornisce questo parametro.

factory
Tipo: Microsoft.Office.Tools.Word.ApplicationFactory
Oggetto che fornisce accesso a funzionalità determinate nel componente aggiuntivo a livello di applicazione.Passa l'oggetto Globals.Factory nel parametro.

Valore restituito

Tipo: Microsoft.Office.Tools.Word.Document
Restituisce un elemento host che estende la funzionalità dell'oggetto Microsoft.Office.Interop.Word.Document corrente.

Nota sull'utilizzo

In Visual Basic e C# è possibile chiamare questo metodo come metodo di istanza su qualsiasi oggetto di tipo _Document. Per chiamare il metodo utilizzando la sintassi del metodo di istanza, omettere il primo parametro. Per ulteriori informazioni, vedere Metodi di estensione (Visual Basic) o Metodi di estensione (Guida per programmatori C#).

Note

In un componente aggiuntivo a livello di applicazione chiamare questo metodo per personalizzare qualsiasi documento aperto in Word. Questo metodo genera un nuovo elemento host Microsoft.Office.Tools.Word.Document se nessun oggetto di questo tipo è già stato generato per l'oggetto Microsoft.Office.Interop.Word.Document sul quale si chiama questo metodo. Le chiamate successive a questo metodo sullo stesso oggetto Microsoft.Office.Interop.Word.Document restituiscono la stessa istanza Microsoft.Office.Tools.Word.Document.

Questo metodo viene fornito per la compatibilità con versioni precedenti di progetti di Office che vengono ridestinati da .NET Framework 3.5 a .NET Framework 4. Nei nuovi progetti che vengono destinati a .NET Framework 4, è necessario chiamare il metodo GetVstoObject fornito dall'oggetto Globals.Factory nel progetto.

Per ulteriori informazioni, vedere Estensione in fase di esecuzione di documenti di Word e di cartelle di lavoro di Excel in componenti aggiuntivi a livello di applicazione.

Nota

Il parametro document è di tipo Microsoft.Office.Interop.Word._Document, che è l'interfaccia padre di Microsoft.Office.Interop.Word.Document. Pertanto, questo metodo estende i tipi Microsoft.Office.Interop.Word._Document e Microsoft.Office.Interop.Word.Document. In genere, quando si fa riferimento un documento di Word, si utilizza un oggetto Microsoft.Office.Interop.Word.Document.

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.