SubmitToHostAdapterObject, interface

  • Article

Représente une connexion permettant d'envoyer des données à un environnement d'hébergement.

Espace de noms : Microsoft.Office.Interop.InfoPath
Assembly : Microsoft.Office.Interop.InfoPath (dans microsoft.office.interop.infopath.dll)

Syntaxe

<GuidAttribute("096CD739-0786-11D1-95FA-0080C78EE3BB")> _
<CoClassAttribute(GetType(SubmitToHostAdapterObjectClass))> _
Public Interface SubmitToHostAdapterObject
    Inherits SubmitToHostAdapter

Dim instance As SubmitToHostAdapterObject

[GuidAttribute("096CD739-0786-11D1-95FA-0080C78EE3BB")] 
[CoClassAttribute(typeof(SubmitToHostAdapterObjectClass))] 
public interface SubmitToHostAdapterObject : SubmitToHostAdapter

Remarques

Ce type est le wrapper d'une classe de composants (coclass) requise par le code managé pour l'interopérabilité COM. Ce type permet d'accéder aux membres de l'interface COM implémentés par cette classe de composants. Pour plus d'informations sur l'interface COM, et pour accéder aux descriptions de ses membres, voir SubmitToHostAdapter.

Ce type de connexion est utilisé dans un modèle de formulaire ouvert par une application qui héberge l'environnement d'édition de formulaires InfoPath en tant que contrôle. Pour plus d'informations sur l'hébergement d'InfoPath en tant que contrôle, notamment pour des informations sur la création d'une méthode permettant de gérer l'événement d'envoi d'un formulaire dans le code de l'application hôte, voir l'article MSDN « Hosting the InfoPath 2007 Form Editing Environment in a Custom Windows Form Application » (Hébergement de l'environnement d'édition de formulaires InfoPath 2007 dans une application de formulaire Windows personnalisée (en anglais).

Pour créer une connexion de données qui permet d'envoyer des données à un environnement d'hébergement pouvant être référencé à partir de la logique métier dans un modèle de formulaire, utilisez la commande Connexions de données du menu Outils. Pour plus d'informations sur la création d'un gestionnaire d'événements à exécuter lors du déclenchement de l'événement OnSubmitRequest, voir Procédure : Ajout d'un gestionnaire d'événements à l'aide du modèle objet InfoPath 2003.

Exemple

L'exemple ci-dessous illustre un modèle à suivre pour écrire du code exécutant des actions personnalisées dans la logique métier d'un modèle de formulaire avant l'envoi du formulaire.

[InfoPathEventHandler(EventType = InfoPathEventType.OnSubmitRequest]
public void FormEvents_OnSubmitRequest(DocReturnEvent e)
{
   // Get the data adapter defined in the form template from the 
   // DataAdapters collection and cast to the SubmitToHostAdapter
   // type.
   SubmitToHostAdapter submitAdapter = 
      (SubmitToHostAdapter)(DataAdapters["MyHostAdapter"]);

   // Write code here to do custom actions that are not 
   // supported by rules or other declarative settings.  

   // Execute the submit operation against the adapter.
   submitAdapter.Submit();

<InfoPathEventHandler(EventType := InfoPathEventType.OnSubmitRequest)>
Public Sub FormEvents_OnSubmitRequest(ByVal e As DocReturnEvent)
   ' Get the data connection defined in the form template from the
   ' DataAdapters collection and cast to the SubmitToHostAdapter
   ' type.
   Dim submitAdapter As SubmitToHostAdapter = _
      DirectCast(DataAdapters("MyHostAdapter"), _
      SubmitToHostAdapter)

   ' Write code here to do custom actions that are not 
   ' supported by rules or other declarative settings.

   ' Execute the submit operation against the connection.
   submitAdapter.Submit()
End Sub

Voir aussi

Référence

Membres SubmitToHostAdapterObject
Microsoft.Office.Interop.InfoPath, espace de noms