XmlForm.Extension Propiedad

Definición

Espacio de nombres:

Microsoft.Office.InfoPath

Ensamblado:

Microsoft.Office.InfoPath.dll

Obtiene un Object para acceder a las funciones y variables globales contenidas en el archivo de código de formulario principal de un formulario mediante System.Reflection.

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

public abstract object Extension { get; }

member this.Extension : obj

Public MustOverride ReadOnly Property Extension As Object

Valor de propiedad

Object

para Object acceder a las funciones y variables globales contenidas en el archivo de código de formulario principal de un formulario mediante System.Reflection.

Ejemplos

En el ejemplo de código siguiente, la propiedad Extension se usa para devolver un objeto System.Object para invocar el método personalizado denominado MyMethod.

object extObj = this.Extension;
extObj.GetType().InvokeMember("MyMethod",
   BindingFlags.InvokeMethod |
   BindingFlags.DeclaredOnly |
   BindingFlags.Public |
   BindingFlags.Instance, null, extObj, null);

Dim extObj As Object extObj = Me.Extension
extObj.GetType().InvokeMember("MyMethod", _
   BindingFlags.InvokeMethod Or _
   BindingFlags.DeclaredOnly Or _
   BindingFlags.Public Or _
   BindingFlags.Instance, Nothing, extObj, Nothing)

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

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

' Custom method added to the form code project.
Function myCustomMethod() As String
   myCustomMethod = "Method value"
End Function

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

objXmlForm = window.external.XmlForm;
myString = objXmlForm.Extension.myCustomMethod();

Dim objXmlForm
Dim myString
Set objXmlForm = window.external.XmlForm
myString = objXmlForm.Extension.myCustomMethod()

Comentarios

El objeto System.Object devuelto por la propiedad Extension posibilita el uso de las funciones y variables globales implementadas en el archivo de código de un formulario de InfoPath. Normalmente, se usa desde un panel de tareas personalizado, un cuadro de diálogo personalizado o en la transformación XSL (XSLT) de una vista en que se puede necesitar acceso directo a las funciones y variables.

Para usar el objeto System.Object en un panel de tareas personalizado, primero debe establecer una referencia al objeto XmlForm mediante la propiedad external de HTML dinámico (DHTML) del objeto DHTML window, como se muestra en este ejemplo.

objXmlForm = window.external.XmlForm;

Ú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.

Únicamente se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler.