DataConnection.Execute Метод

Определение

Пространство имен:

Microsoft.Office.InfoPath

Сборка:

Microsoft.Office.InfoPath.dll

В зависимости от класса ConnectionTypeConnection, из которого осуществляется вызов, выполняет операцию отправки или запроса в подключение данных с помощью декларативно определенных значений для отправляемых данных, параметров запроса или извлекаемых данных.

public:
 abstract void Execute();

public abstract void Execute ();

abstract member Execute : unit -> unit

Public MustOverride Sub Execute ()

Исключения

WebException

Не удалось выполнить операцию.

ArgumentNullException

Параметры, передаваемые этому методу, являются пустой ссылкой (Nothing в Visual Basic).

ArgumentException

Этому методу переданы недопустимые параметры. Например, неправильный тип или формат.

InvalidOperationException

Для операций отправки Execute() метод был вызван из обработчика событий для Loading события.

SEHException

Из-за неуправляемого кода произошла ошибка структурированного обработчика исключений (SEH), которая не связана с соответствующим исключением управляемого кода. Для получения дополнительной информации проведите поиск по ключевым словам "unmanaged exceptions" и "Structured Exception Handling" в библиотеке MSDN.

Примеры

В следующем примере после того, как свойство Command класса ADOQueryConnection используется для обновления текста команды SQL подключения к данным, метод DataConnectionExecute класса используется для выполнения запроса для обновления данных в форме.

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

Комментарии

При конструировании шаблона формы можно использовать команду Действия на вкладке Данные, чтобы определить назначение отправки и связанные параметры, сохраненные в файле определения решения файла шаблона формы (XSF). Также можно использовать команду Подключения данных на вкладке Данные, чтобы определить параметры отправки или получения данных, которые сохранены в файле определения решения (XSF). Execute() С помощью метода выполняется операция отправки или запроса для подключения к данным с помощью этих декларативно определенных параметров.

Метод DataConnection.Execute наследуется всеми классами, представляющими подключения данных, и отображается как унаследованный метод такого класса, например, метод EmailSubmitConnection.Execute(). В зависимости от типа подключения данных, которое представляет наследующий класс, метод Execute будет выполнять объявленную операцию отправки или запроса, соответствующую этому подключению.

AdoQueryConnection	Запрос
AdoSubmitConnection	Отправить
BdcQueryConnection	Запрос
BdcSubmitConnection	Отправить
EmailSubmitConnection	Отправить
FileQueryConnection	Запрос
FileSubmitConnection	Отправить
SharePointListRWQueryConnectionПримечание. SharepointListQueryConnection Класс, используемый в предыдущих версиях InfoPath, устарел.	Запрос
WebServiceConnection	Отправка или запрос

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

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