DataConnection.Execute-Methode

Artikel
05/05/2015

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

Ausnahme	Bedingung
WebException	Fehler bei dem Ausführungsvorgang.
ArgumentNullException	Die an diese Methode übergebenen Parameter sind ein Nullverweis (Nothing in Visual Basic).
ArgumentException	Die an diese Methode übergebenen Parameter sind ungültig. Sie weisen beispielsweise den falschen Typ oder das falsche Format auf.
InvalidOperationException	Für Sendevorgänge wurde die Execute()-Methode aus einem Ereignishandler für das Loading-Ereignis aufgerufen.
SEHException	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.

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. 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.

Klasse	Operation
AdoQueryConnection	Abfragevorgang
AdoSubmitConnection	Sendevorgang
BdcQueryConnection	Abfragevorgang
BdcSubmitConnection	Sendevorgang
EmailSubmitConnection	Sendevorgang
FileQueryConnection	Abfragevorgang
FileSubmitConnection	Sendevorgang
SharePointListRWQueryConnection Hinweis Die in früheren Versionen von InfoPath verwendete SharepointListQueryConnection-Klasse ist veraltet.	Abfragevorgang
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.

Beispiele

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

Share via