DataConnection.Execute-Methode

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.

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

Syntax

'Declaration
Public MustOverride Sub Execute
'Usage
Dim instance As DataConnection

instance.Execute

public abstract void Execute ()

Ausnahmen

Ausnahmetyp	Bedingung
WebException	Fehler bei dem Ausführungsvorgang.

Hinweise

Beim Entwerfen einer Formularvorlage können Sie den Befehl Absendeoptionen im Menü Extras verwenden, um das Sendeziel und die zugehörigen Einstellungen, die in der Lösungsdefinitionsdatei (XSF) der Formularvorlage gespeichert sind, zu definieren. Sie können auch den Befehl Datenverbindungen im Menü Extras zum Definieren von Einstellungen für das Senden und Empfangen von Daten verwenden, die ebenfalls in der Lösungsdefinitionsdatei (XSF) gespeichert werden. Mithilfe der Execute-Methode werden diese deklarativ definierten Einstellungen zum Ausführen eines Sende- oder Abfragevorgangs in der Datenverbindung verwendet.

Die DataConnection.Execute-Methode wird von allen Klassen, die Datenverbindungen darstellen, geerbt, und als geerbte Methode dieser Klasse (z. B. die EmailSubmitConnection.Execute()-Methode) verfügbar gemacht. Je nach der von der geerbten Klasse dargestellten Datenverbindungsart führt die Execute-Methode den deklarierte Sende- oder Abfragevorgang für diese Verbindung aus.

AdoQueryConnection

Abfragevorgang

AdoSubmitConnection

Sendevorgang

EmailSubmitConnection

Sendevorgang

FileQueryConnection

Abfragevorgang

FileSubmitConnection

Sendevorgang

SharepointListQueryConnection

Abfragevorgang

WebServiceConnection

Sende- oder Abfragevorgang

Auf den Member kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das zurzeit geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.

Auf diesen Typ oder diesen Member kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft Office InfoPath 2007 oder einem Webbrowser geöffnet wurden.

Beispiel

Im folgenden Beispiel wird – nach dem Aktualisieren des SQL-Befehltextes der Datenverbindung mithilfe der Command-Eigenschaft der ADOQueryConnection-Klasse – die Execute-Methode der DataConnection-Klasse zum Ausführen der Abfrage verwendet, um die Formulardaten zu aktualisieren.

public void RefreshData_Clicked(object sender, ClickedEventArgs e)
{
   // Get the Employees connection from the 
   // DataConnections collection.
   AdoQueryConnection myAdoQueryConnection =
      (AdoQueryConnection)(this.DataConnections["Employees"]);

   // Get the employee's ID from the EmpID field in 
   // the main data source.
   XPathNavigator myNav = 
      CreateNavigator().SelectSingleNode("/my:myFields/my:EmpID", 
      NamespaceManager);
   // Assign the value from the field to a variable.
   string employeeID = myNav.InnerXml;

   // Change the SQL command for Employees connection to retrieve 
   // the record of the Employee's ID entered by the user.
   myAdoQueryConnection.Command = 
      "select * from [Employees] where [EmployeeID] = " + employeeID;

   // Execute the updated command against the data connection to 
   // refresh the data.
   myAdoQueryConnection.Execute();
}

Public Sub RefreshData_Clicked(ByVal sender As Object, ByVal e As ClickedEventArgs)
   ' Get the Employees connection from the 
   ' DataConnections collection.
   Dim myAdoQueryConnection As AdoQueryConnection = _
      DirectCast(Me.DataConnections("Employees"), AdoQueryConnection)

   ' Get the employee's ID from the EmpID field in 
   ' the main data source.
   Dim myNav As XPathNavigator = _
      CreateNavigator().SelectSingleNode("/my:myFields/my:EmpID", _
      NamespaceManager)
   Dim employeeID As String = myNav.InnerXml

   ' Change the SQL command for Employees connection to retrieve 
   ' the record of the Employee's ID entered by the user.
   myAdoQueryConnection.Command = _
      "select * from [Employees] where [EmployeeID] = " + employeeID

   ' Execute the updated command against the data connection to 
   ' refresh the data.
    myAdoQueryConnection.Execute()
End Sub

Siehe auch

Referenz

DataConnection-Klasse
DataConnection-Member
Microsoft.Office.InfoPath-Namespace