_XDocument4.Extension Propiedad

Definición

Espacio de nombres:

Microsoft.Office.Interop.InfoPath.SemiTrust

Ensamblado:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

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

public:
 property System::Object ^ Extension { System::Object ^ get(); };

public object Extension { get; }

member this.Extension : obj

Public ReadOnly Property Extension As Object

Valor de propiedad

Object

Implementaciones

Extension

Ejemplos

En el ejemplo siguiente, la propiedad Extension se usa a través de la ObjectWrapper interfaz 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].<span class="label">Extension</span>;
 o.GetType().InvokeMember("MyMethod",
 BindingFlags.InvokeMethod |
 BindingFlags.DeclaredOnly | 
 BindingFlags.Public |  
 BindingFlags.Instance, null, o, null);

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

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

Para obtener acceso myCustomMethod desde el panel de tareas personalizado, use la propiedad externa DHTML del objeto de ventana DHTML:

objXDocument = window.external.XDocument;
myString = objXDocument.<span class="label">Extension</span>.myCustomMethod();

En el ejemplo siguiente, la propiedad Extension se usa a través de la ObjectWrapper interfaz 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].<span class="label">Extension</span>;
 o.GetType().InvokeMember("MyMethod",
 BindingFlags.InvokeMethod |
 BindingFlags.DeclaredOnly | 
 BindingFlags.Public |  
 BindingFlags.Instance, null, o, null);

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

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

Para obtener acceso myCustomMethod desde el panel de tareas personalizado, use la propiedad externa DHTML del objeto de ventana DHTML:

objXDocument = window.external.XDocument;
myString = objXDocument.<span class="label">Extension</span>.myCustomMethod();

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 usar el objeto Extension en un panel de tareas personalizado, primero debe establecer una referencia al objeto XDocument mediante la propiedad external de HTML dinámico (DHTML) del objeto DHTML window, como se muestra en este ejemplo.

objXDocument = window.external.XDocument;

Importante: Solo se puede acceder a este miembro mediante formularios que se ejecutan en el mismo dominio que el formulario abierto actualmente o mediante formularios a los que se han concedido permisos entre dominios.