AdoQueryConnection.Command-Eigenschaft

Artikel
04/27/2010

Ruft den SQL-Befehlszeichenfolgentext für ein AdoQueryConnection-Objekt ab, oder legt ihn fest.

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

Syntax

'Declaration
Public MustOverride Property Command As String
'Usage
Dim instance As AdoQueryConnection
Dim value As String

value = instance.Command

instance.Command = value

public abstract string Command { get; set; }

Eigenschaftswert

Der SQL-Befehlstext der Datenverbindung.

Hinweise

Die Command-Eigenschaft des ADOQueryConnection-Objekts enthält den SQL-Befehltext, der von der ADO-Datenverbindung (ActiveX Data Objects) verwendet wird, um Daten aus einer externen ADO-/OLEDB-Datenquelle abzurufen.

Hinweis

Das ADOQueryConnection-Objekt kann nur bei Microsoft SQL Server- und Microsoft Access-Datenbanken verwendet werden.

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 die Command-Eigenschaft der ADOQueryConnection-Klasse und die Execute-Methode der DataConnection-Klasse verwendet, um eine Tabelle in der sekundären Datenquelle mit der Bezeichnung Employee abzufragen. Die Abfrage wird für die Datenverbindung ausgeführt, die im InfoPath-Entwurfsmodus in der Datenbank erstellt wurde, die die Employee-Tabelle (ebenfalls mit der Bezeichnung "Employee") enthält.

Als Erstes wird mithilfe der Command-Eigenschaft der vom Benutzer im Feld my:EmpID eingegebene Wert zum Aktualisieren des SQL-Befehlstextes verwendet. Anschließend werden mithilfe der Execute-Methode die über die Datenverbindung abgerufenen Daten aktualisiert. Dabei wird der im Steuerelement Wiederholte Tabelle (mit Bindung an die Employee-Tabelle im Formular) angezeigte Datensatz aktualisiert. Dieses Beispiel erfordert das my:EmpID-Feld in der Hauptdatenquelle, die an ein Textfeld-Steuerelement in einer Ansicht gebunden ist, die ein Steuerelement Button für den Aufruf des folgenden Codes enthält.

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

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

Freigeben über