AdoSubmitConnection.Command 属性

定义

命名空间:

Microsoft.Office.InfoPath

程序集:

Microsoft.Office.InfoPath.dll

获取或设置 对象的 SQL 命令字符串文本 AdoSubmitConnection 。

public:
 abstract property System::String ^ Command { System::String ^ get(); void set(System::String ^ value); };

public abstract string Command { get; set; }

member this.Command : string with get, set

Public MustOverride Property Command As String

属性值

String

数据连接的 SQL 命令字符串。

示例

在以下示例中，AdoSubmitConnection 类的 Command 属性和 Execute() 类的 DataConnection 方法用于查询名为 Employees 的辅助数据源中的表。 针对在 InfoPath 设计模式下创建的数据连接执行查询，该连接与包含 Employees 表的数据库（名为“EmployeesSubmit”）。

首先，使用用户在 my:EmpID 域中输入的值以及 Command 属性更新 SQL 命令文本。 然后， Execute 方法用于刷新数据连接检索的数据，这将更新绑定到窗体上 Employees 表的重复表控件中显示的记录。 此示例要求主数据源中的 my:EmpID 域绑定到包含 Button 控件的视图中的“Text Box”控件，只有这样才能调用下面的代码。

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

注解

ADOSubmitConnection 对象的 Command 属性包含 SQL 命令文本，ADO 数据连接使用这些文本向 ActiveX 数据对象/OLEDB 外部数据源提交数据。

重要提示：仅当存在相应的 ADOQueryConnection 对象时，ADOSubmitConnection 对象才能存在，并且这两个对象表示的数据连接共享同一组属性值。 如果更改 ADOSubmitConnection 对象的此属性值，也会更改相应 ADOQueryConnection 对象的同一属性的值。

注意：ADOSubmitConnection 对象仅限于 Microsoft SQL Server 和 Microsoft Access 数据库。

此成员只能由与当前打开的表单在相同域中运行的表单访问，或者由已授予跨域权限的表单访问。

可以通过 Microsoft InfoPath Filler 中打开的表单中运行的代码访问此类型或成员。