AdoSubmitConnection.Command-Eigenschaft

Artikel
04/27/2010

Ruft den SQL-Befehlszeichenfolgentext für ein AdoSubmitConnection-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 AdoSubmitConnection
Dim value As String

value = instance.Command

instance.Command = value

public abstract string Command { get; set; }

Eigenschaftswert

Die SQL-Befehlszeichenfolge für die Datenverbindung.

Hinweise

Die Command-Eigenschaft des ADOSubmitConnection-Objekts enthält den SQL-Befehlstext, der von der ADO-Datenverbindung verwendet wird, um Daten an eine externe ActiveX Data Objects/OLEDB-Datenquelle zu senden.

Wichtig

Ein ADOSubmitConnection-Objekt kann nur vorhanden sein, wenn ein entsprechendes ADOQueryConnection-Objekt vorhanden ist und die durch beide Objekte dargestellten Datenverbindungen dieselbe Eigenschaftenwertegruppe teilen. Wenn der Wert dieser Eigenschaft für das ADOSubmitConnection-Objekt geändert wird, wird auch der Wert dieser Eigenschaft für das entsprechende ADOQueryConnection-Objekt geändert.

Hinweis

Das ADOSubmitConnection-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 nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft Office InfoPath 2007 geöffnet wurden.

Beispiel

Im folgenden Beispiel wird mithilfe der Command-Eigenschaft der AdoSubmitConnection-Klasse und der Execute-Methode der DataConnection-Klasse eine Tabelle in einer sekundären Datenquelle mit dem Namen Employees abgefragt. Die Abfrage wird für die Datenverbindung ausgeführt, die im InfoPath-Entwurfsmodus für die Datenbank erstellt wurde, die die Employees-Tabelle enthält und "EmployeesSubmit" heißt.

Zuerst wird mit dem Wert, der vom Benutzer im my:EmpID-Feld eingegeben wird, der SQL-Befehlstext mithilfe der Command-Eigenschaft aktualisiert. Dann werden mithilfe der Execute-Methode die Daten aktualisiert, die von der Datenverbindung abgefragt werden, die den Datensatz aktualisiert, der in einem Steuerelement vom Typ Wiederholte Tabelle angezeigt wird. Das Steuerelement ist an die Employees-Tabelle im Formular gebunden. Für dieses Beispiel ist erforderlich, dass das my:EmpID-Feld in der primären Datenquelle an ein Steuerelement vom Typ Textfeld in einer Ansicht gebunden ist, die ein Steuerelement Button zum Aufrufen des folgenden Codes enthält.

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

   // 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.
   myAdoSubmitConnection.Command = 
      "select * from [Employees] where [EmployeeID] = " + employeeID;

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

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

   ' 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.
    myAdoSubmitConnection.Execute()
End Sub

Siehe auch

Referenz

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

Freigeben über