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 Typ der Verbindung wird in einer Formularvorlage verwendet, die von einer Anwendung geöffnet ist, die das InfoPath-Formular Formularbearbeitungsumgebung als Steuerelement gehostet wird. Weitere Informationen zum Hosten von InfoPath als Steuerelement, einschließlich Informationen zum Erstellen einer Methode für die Ereignisbehandlung zum Absenden eines Formulars in der Hostanwendung Code finden Sie im Artikel Hosten der InfoPath Formular bearbeiten-Umgebung in einer benutzerdefinierten Windows Forms-Anwendung 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. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.