Freigeben über


DataConnection.Execute Methode

Definition

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.

public:
 abstract void Execute();
public abstract void Execute ();
abstract member Execute : unit -> unit
Public MustOverride Sub Execute ()

Ausnahmen

Fehler bei dem Ausführungsvorgang.

Die an diese Methode übergebenen Parameter sind ein NULL-Verweis (Nothing in Visual Basic).

Die an diese Methode übergebenen Parameter sind nicht gültig. Die Parameter weisen beispielsweise den falschen Typ oder das falsche Format auf.

Bei Übermittlungsvorgängen wurde die Execute() -Methode von einem Ereignishandler für das Loading -Ereignis aufgerufen.

Ein SEH-Fehler (Structured Exception Handler) wurde von nicht verwaltetem Code ausgelöst, der keiner entsprechenden Ausnahme für verwalteten Code zugeordnet ist. Weitere Informationen erhalten Sie, indem Sie in der MSDN Library nach "nicht verwaltete Ausnahmen" und "strukturierte Ausnahmebehandlung" suchen.

Beispiele

Im folgenden Beispiel wird, nachdem die Command-Eigenschaft der ADOQueryConnection-Klasse verwendet wurde, um den SQL-Befehlstext der Datenverbindung zu aktualisieren, die Execute-Methode der DataConnection -Klasse verwendet, um die Abfrage auszuführen, um die Daten im Formular 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

Hinweise

Beim Entwerfen einer Formularvorlage können Sie die Befehle Aktionen übermitteln auf der Registerkarte Daten 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 auf der Registerkarte Daten zum Definieren von Einstellungen für das Senden und Empfangen von Daten verwenden, die in der Lösungsdefinitionsdatei (XSF) gespeichert werden. Die Verwendung der Execute() -Methode führt einen Sende- oder Abfragevorgang für die Datenverbindung mithilfe dieser deklarativ definierten Einstellungen aus.

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 Abfrage
AdoSubmitConnection Senden
BdcQueryConnection Abfrage
BdcSubmitConnection Senden
EmailSubmitConnection Senden
FileQueryConnection Abfrage
FileSubmitConnection Senden
SharePointListRWQueryConnectionHinweisDie SharepointListQueryConnection in früheren Versionen von InfoPath verwendete Klasse ist veraltet.Abfrage
WebServiceConnection Sende- oder Abfragevorgang

Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.

Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.

Gilt für: