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 для подключения данных.

Примеры

В следующем примере свойство Command класса AdoSubmitConnection и Execute() метод DataConnection класса используются для запроса таблицы во вторичном источнике данных с именем Employees. Запрос выполняется с помощью подключения данных с именем "EmployeesSubmit", созданного в режиме конструктора InfoPath, к базе данных, содержащей таблицу Employees.

Сначала значение, введенное пользователем в поле my:EmpID, используется для обновления текста команды SQL с помощью свойства Command. Затем метод Execute используется для обновления данных, полученных подключением к данным, который обновляет запись, отображаемую в элементе управления Повторяющаяся таблица, привязанном к таблице Employees в форме. В этом примере требуется привязка поля my:EmpID в основном источнике данных к элементу управления Текстовое поле в представлении, которое содержит элемент управления Button для запуска следующего кода.

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

Комментарии

Свойство Command объекта ADOSubmitConnection содержит текст команды SQL, которая используется ADO-подключением для отправки данных на внешний источник данных ADO или OLEDB.

Важно! Объект ADOSubmitConnection может существовать только в том случае, если имеется соответствующий объект ADOQueryConnection , а подключения к данным, представленные обоими объектами, используют один и тот же набор значений свойств. При изменении значения свойства для объекта ADOSubmitConnection также изменяется значение того же свойства соответствующего объекта ADOQueryConnection.

Примечание. Объект ADOSubmitConnection ограничен работой только с базами данных Microsoft SQL Server и Microsoft Access.

Доступ к этому элементу предоставляется только формам, работающим в том же домене, что и текущая открытая форма, а также формам с междоменными правами доступа.

Доступ к этому типу или элементу предоставляется только из кода, выполняющегося в формах, открытых в Microsoft InfoPath Filler.