Compartir a través de


de la propiedad _XDocument3.Extension

Obtiene una referencia al objeto de secuencias de comando global, que expone las funciones y variables globales contenidas en el archivo de código de formulario principal de un formulario de Microsoft InfoPath.

Espacio de nombres:  Microsoft.Office.Interop.InfoPath.SemiTrust
Ensamblado:  Microsoft.Office.Interop.InfoPath.SemiTrust (en Microsoft.Office.Interop.InfoPath.SemiTrust.dll)

Sintaxis

'Declaración
ReadOnly Property Extension As Object
    Get
'Uso
Dim instance As _XDocument3
Dim value As Object

value = instance.Extension
Object Extension { get; }

Valor de propiedad

Tipo: System.Object

Implementaciones

_XDocument2.Extension
_XDocument.Extension

Comentarios

El objeto Extension facilita el uso de las funciones y las variables globales implementadas en el archivo de secuencias de comandos de un formulario de InfoPath. Normalmente, se utiliza desde un panel de tareas personalizado, desde un cuadro de diálogo personalizado o en la transformación XSL (XSLT) de una vista, donde pueda ser necesario tener acceso directo a las funciones y variables.

Para utilizar Extension en un panel de tareas personalizado, deberá establecerse previamente una referencia al objeto XDocument mediante la propiedad external de HTML dinámico (DHTML) del objeto window de DHTML, como se muestra en este ejemplo:

objXDocument = window.external.XDocument;

Importante

Únicamente se puede acceder a este miembro con formularios que se ejecuten en el mismo dominio que el formulario que está actualmente abierto o con formularios a los que se hayan concedido permisos entre dominios.

Ejemplos

En el siguiente ejemplo, se utiliza la propiedad Extension a través de la interfaz ObjectWrapper para invocar el método personalizado denominado MyMethod. Esto es necesario cuando se utiliza la propiedad Extension en código administrado:

ObjectWrapper o = (ObjectWrapper)thisApplication.XDocuments[0].Extension;
 o.GetType().InvokeMember("MyMethod",
 BindingFlags.InvokeMethod |
 BindingFlags.DeclaredOnly | 
 BindingFlags.Public |  
 BindingFlags.Instance, null, o, null);

En el siguiente ejemplo, se puede tener acceso a un método denominado myCustomMethod de la clase de proyecto de InfoPath desde el panel de tareas personalizado mediante la propiedad Extension:

//Custom method added to the project
public string myCustomMethod()
{
return "Method value";
}

Para tener acceso a myCustomMethod desde el panel de tareas personalizado, utilice la propiedad external de DHTML del objeto window de DHTML:

objXDocument = window.external.XDocument;
myString = objXDocument.Extension.myCustomMethod();

Vea también

Referencia

interfaz _XDocument3

Miembros _XDocument3

Sobrecarga Extension

Espacio de nombres Microsoft.Office.Interop.InfoPath.SemiTrust