SubmitToHostConnection-Klasse

Artikel
04/27/2010

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

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

Syntax

'Declaration
Public MustInherit Class SubmitToHostConnection
    Inherits DataConnection
'Usage
Dim instance As SubmitToHostConnection

public abstract class SubmitToHostConnection : DataConnection

Hinweise

Dieser Verbindungstyp wird in einer Formularvorlage verwendet, die von einer Anwendung geöffnet wird, die die InfoPath-Formularbearbeitungsumgebung als Steuerelement hostet. 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 Artikel "Hosting the InfoPath Form Editing Environment in a Custom Windows Form Application" im InfoPath-Entwicklerportal (in Englisch) 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. Informationen zum Erstellen eines Ereignishandlers, der ausgeführt wird, wenn das Submit-Ereignis ausgelöst wird, finden Sie unter Vorgehensweise: Hinzufügen eines Ereignishandlers.

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.

public void FormEvents_Submit(object sender, SubmitEventArgs e)
{
   // Get the data connection defined in the form template from the 
   // DataConnections collection and cast to the SubmitToHostConnection
   // type.
   SubmitToHostConnection submitConnection = 
      (SubmitToHostConnection)(DataConnections["MyHostConnection"]);

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

   // Execute the submit operation against the connection.
   submitConnection.Execute();

}

Public Sub FormEvents_Submit(ByVal sender As Object, _
   ByVal e As SubmitEventArg)
   ' Get the data connection defined in the form template from the
   ' DataConnections collection and cast to the SubmitToHostConnection
   ' type.
   Dim submitConnection As SubmitToHostConnection = _
      DirectCast(DataConnections("MyHostConnection"), _
      SubmitToHostConnection)

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

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

Vererbungshierarchie

System.Object
Microsoft.Office.InfoPath.DataConnection
Microsoft.Office.InfoPath.SubmitToHostConnection

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

SubmitToHostConnection-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über