XmlForm.Extension Propriété

Définition

Espace de noms:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Obtient un Object pour accéder aux fonctions et variables globales contenues dans le fichier de code de formulaire principal d’un formulaire à l’aide de 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

Valeur de propriété

Object

pour Object accéder aux fonctions et aux variables globales contenues dans le fichier de code de formulaire principal d’un formulaire à l’aide de System.Reflection.

Exemples

Dans l’exemple de code suivant, la propriété Extension est utilisée pour renvoyer un System.Object afin d’appeler la méthode personnalisée appelée 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)

Dans l’exemple de code suivant, une méthode appelée myCustomMethod de la classe de projet de code de formulaire InfoPath est accessible à partir du volet Office personnalisé à l’aide de la propriété 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

Pour accéder à myCustomMethod partir d’un script dans le volet Office personnalisé, utilisez la propriété externe DHTML de l’objet de fenêtre DHTML.

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

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

Remarques

L’objet System.Object renvoyé par la propriété Extension facilite l’utilisation des fonctions et variables globales implémentées dans le fichier de code d’un formulaire InfoPath. Généralement, il est utilisé à partir d’un volet Office personnalisé, à partir d’une boîte de dialogue personnalisée ou dans la transformation XSL (XSLT) d’une vue où l’accès direct aux fonctions et aux variables s’avère parfois nécessaire.

Pour utiliser System.Object dans un volet Office personnalisé, vous devez d’abord définir une référence à l’objet XmlForm à l’aide de la propriété external DHTML (Dynamic HTML) de l’objet window DHTML, comme l’illustre cet exemple.

objXmlForm = window.external.XmlForm;

Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.

Vous pouvez uniquement accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.