SubmitToHostConnection-Klasse
Stellt eine Verbindung zum Senden von Daten an eine Hostumgebung dar.
Vererbungshierarchie
System.Object
Microsoft.Office.InfoPath.DataConnection
Microsoft.Office.InfoPath.SubmitToHostConnection
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 "Hosten der InfoPath-Formularbearbeitungsumgebung in einer benutzerdefinierten Windows-Formularanwendung" im InfoPath-Entwicklerportal auf MSDN.
Verwenden Sie den Befehl Datenverbindungen auf der Registerkarte Daten des Menübands, 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.
Beispiele
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
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.