DocumentExtensions.GetVstoObject (Método) (_Document, Factory)

Devuelve un elemento host Microsoft.Office.Tools.Word.Document que extiende la funcionalidad del objeto Microsoft.Office.Interop.Word.Document actual en una personalización del nivel de documento. Pasa el objeto Globals.Factory del proyecto al parámetro factory.

Espacio de nombres: Microsoft.Office.Tools.Word.Extensions
Ensamblado: Microsoft.Office.Tools.Word.v4.0.Utilities (en Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Sintaxis

'Declaración
<ExtensionAttribute> _
Public Shared Function GetVstoObject ( _
    document As _Document, _
    factory As Factory _
) As Document

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

Parámetros

document
Tipo: Microsoft.Office.Interop.Word._Document
Objeto de documento nativo que se va a extender.No proporcione este parámetro personalmente.Al llamar a este método en un documento de Word, el motor en tiempo de ejecución proporciona este parámetro.

factory
Tipo: Microsoft.Office.Tools.Word.Factory
Objeto que proporciona acceso a determinadas características de la personalización del nivel del documento.Pasa el objeto Globals.Factory a este parámetro.

Valor devuelto

Tipo: Microsoft.Office.Tools.Word.Document
Elemento host que extiende la funcionalidad del objeto Microsoft.Office.Interop.Word.Document actual.

Nota sobre el uso

En Visual Basic y C#, se puede llamar a este método como a un método de instancia en cualquier objeto de tipo _Document. Cuando emplee la sintaxis del método de instancia para llamar a este método, omita el primer parámetro. Para obtener más información, vea Métodos de extensión (Visual Basic) o Métodos de extensión (Guía de programación de C#).

Comentarios

En una personalización de nivel de documento, puede llamar a este método para obtener un elemento host Microsoft.Office.Tools.Word.Document que está en la personalización actual. Si el objeto Microsoft.Office.Interop.Word.Document en el que llama a este método no es el objeto subyacente de un elemento host Microsoft.Office.Tools.Word.Document en la personalización actual, este método devuelve nullreferencia null (Nothing en Visual Basic).

Este método se proporciona para compatibilidad con versiones anteriores de proyectos de Office que se vuelven a establecer desde .NET Framework 3.5 a .NET Framework 4. En nuevos proyectos destinados a .NET Framework 4, debería llamar al método GetVstoObject que proporciona el objeto Globals.Factory en su proyecto. Para obtener más información, vea Obtener objetos extendidos a partir de objetos nativos de Office en personalizaciones en el nivel del documento.

Nota

El parámetro document es de tipo Microsoft.Office.Interop.Word._Document, que es la interfaz primaria de Microsoft.Office.Interop.Word.Document. Por consiguiente, este método extiende ambos tipos: Microsoft.Office.Interop.Word._Document y Microsoft.Office.Interop.Word.Document. Normalmente, al hacer referencia a un documento de Word, se utiliza un Microsoft.Office.Interop.Word.Document.

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.