Свойство AdoSubmitConnection.Command

Статья
04/27/2010

Возвращает или задает текст строки команды SQL для объекта AdoSubmitConnection.

Пространство имен: Microsoft.Office.InfoPath
Сборка: Microsoft.Office.InfoPath (в microsoft.office.infopath.dll)

Синтаксис

'Декларация
Public MustOverride Property Command As String
'Применение
Dim instance As AdoSubmitConnection
Dim value As String

value = instance.Command

instance.Command = value

public abstract string Command { get; set; }

Значение свойства

Строка команды SQL для подключения данных.

Заметки

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

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

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

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

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

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

Пример

В следующем примере свойство 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

См. также

Ссылка

Класс AdoSubmitConnection
Члены AdoSubmitConnection
Пространство имен Microsoft.Office.InfoPath

Поделиться через