_XDocument2.Extension - Propriété

Obtient une référence à l'objet de script global, qui expose les fonctions et variables globales contenues dans le fichier de code de formulaire principal d'un formulaire.

Espace de noms :  Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly :  Microsoft.Office.Interop.InfoPath.SemiTrust (dans Microsoft.Office.Interop.InfoPath.SemiTrust.dll)

Syntaxe

'Déclaration
ReadOnly Property Extension As Object
    Get
'Utilisation
Dim instance As _XDocument2
Dim value As Object

value = instance.Extension
Object Extension { get; }

Valeur de propriété

Type : System.Object

Implémentations

_XDocument.Extension

Remarques

L'objet Extension facilite l'utilisation des fonctions et des variables globales implémentées dans le fichier de script 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 risque d'être nécessaire.

Pour utiliser la propriété Extension dans un volet Office personnalisé, vous devez d'abord définir une référence à l'objet XDocument à l'aide de la propriété external DHTML de l'objet Window DHTML, comme l'illustre l'exemple suivant :

objXDocument = window.external.XDocument;

Important

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.

Exemples

Dans l'exemple suivant, la propriété Extension est utilisée via l'interface ObjectWrapper pour invoquer la méthode personnalisée nommée MyMethod. Cela s'avère nécessaire lorsque vous utilisez la propriété Extension dans du code géré :

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

Dans l'exemple suivant, une méthode appelée myCustomMethod de la classe Project d'InfoPath est accessible via le volet Office personnalisé à l'aide de la propriété Extension :

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

Pour accéder à myCustomMethod à partir du volet Office personnalisé, utilisez la propriété external de l'objet DHTML window :

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

Voir aussi

Référence

_XDocument2 interface

_XDocument2 - Membres

Extension - Surcharge

Microsoft.Office.Interop.InfoPath.SemiTrust - Espace de noms