SubmitToHostAdapterObject-Schnittstelle

  • Artikel

Stellt eine Verbindung zum Senden von Daten an eine Hostumgebung dar.

Namespace: Microsoft.Office.Interop.InfoPath
Assembly: Microsoft.Office.Interop.InfoPath (in microsoft.office.interop.infopath.dll)

Syntax

<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

Hinweise

Dies ist ein Wrappertyp für eine Coklasse, die für den verwalteten Code der COM-Interoperabilität erforderlich ist. Verwenden Sie diesen Typ zum Zugreifen auf die Member der COM-Schnittstelle, die von der Coklasse implementiert wurden. Informationen zur COM-Schnittstelle, einschließlich eines Links zu den Memberbeschreibungen, finden Sie unter SubmitToHostAdapter.

Dieser Verbindungstyp wird in einer Formularvorlage verwendet, die von einer Anwendung geöffnet wird, die die InfoPath-Formularbearbeitungsumgebung als Steuerelement hostet. Weitere Informationen zum Hosten von InfoPath als Steuerelement, einschließlich Informationen zum Erstellen einer Methode zum Verwenden des Ereignisses zum Senden eines Formulars im Code Ihrer Hostanwendung finden Sie im MSDN-Artikel Hosting the InfoPath 2007 Form Editing Environment in a Custom Windows Form Application auf MSDN.

Verwenden Sie den Befehl Datenverbindungen im Menü Extras, um eine Datenverbindung zum Senden von Daten an eine Hostumgebung zu erstellen, auf die von einer Geschäftslogik in einer Formularvorlage verwiesen werden kann. Weitere Informationen zum Erstellen eines Ereignishandlers, der ausgeführt wird, wenn das OnSubmitRequest-Ereignis ausgelöst wird, finden Sie unter Vorgehensweise: Hinzufügen eines Ereignishandlers mit dem InfoPath 2003-Objektmodell.

Beispiel

Im folgenden Beispiel ist ein Muster zum Schreiben von Code dargestellt, mit dem benutzerdefinierte Aktionen in der Geschäftslogik einer Formularvorlage ausgeführt werden, bevor das Formular gesendet wird.

[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

Siehe auch

Referenz

SubmitToHostAdapterObject-Member
Microsoft.Office.Interop.InfoPath-Namespace