SubmitToHostConnection Klasse

Referenz

Definition

Namespace:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

public ref class SubmitToHostConnection abstract : Microsoft::Office::InfoPath::DataConnection

public abstract class SubmitToHostConnection : Microsoft.Office.InfoPath.DataConnection

type SubmitToHostConnection = class
    inherit DataConnection

Public MustInherit Class SubmitToHostConnection
Inherits DataConnection

Vererbung: Object

DataConnection
SubmitToHostConnection

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

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 Behandeln des Ereignisses zum Senden eines Formulars im Code Ihrer Hostanwendung, finden Sie im Artikel Hosten der InfoPath-Formularbearbeitungsumgebung in einer benutzerdefinierten Windows Form-Anwendung.

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.

Konstruktoren

SubmitToHostConnection()

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

Eigenschaften

Name	Ruft den Namen der Datenverbindung ab. (Geerbt von DataConnection)

Methoden

Execute()

Je nachdem, von welcher ConnectionType die Connection-Klasse aufgerufen wird, wird ein Sende- oder Abfragevorgang in der Datenverbindung ausgeführt. Dabei werden deklarativ definierte Werte für die gesendeten Daten, Abfrageparameter oder abzurufenden Daten verwendet.

(Geerbt von DataConnection)

Gilt für:

Freigeben über