Свойство AdoQueryConnection.Command

Статья
04/27/2010

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

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

Синтаксис

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

value = instance.Command

instance.Command = value

public abstract string Command { get; set; }

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

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

Заметки

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

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

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

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

Пример

В следующем примере свойство Command класса ADOQueryConnection и метод Execute класса DataConnection используются для запроса таблицы в дополнительном источнике данных с именем Employees. Запрос выполняется с помощью подключения данных с именем "Employees", созданного в режиме конструктора 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.
   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

См. также

Ссылка

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

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