del método DataConnection.Execute

Dependiendo de la clase ConnectionTypeConnection desde la que se llame, ejecuta una operación de envío o consulta en la conexión de datos utilizando los valores definidos declarativamente para los datos enviados o los datos que se deben recuperar.

Espacio de nombres:  Microsoft.Office.InfoPath
Ensamblado:  Microsoft.Office.InfoPath (en Microsoft.Office.InfoPath.dll)

Sintaxis

'Declaración
Public MustOverride Sub Execute
'Uso
Dim instance As DataConnection

instance.Execute()

public abstract void Execute()

Excepciones

Excepción	Condición
WebException	Error de la operación de recuperación.
ArgumentNullException	Los parámetros pasados a este método son una referencia null (Nothing en Visual Basic).
ArgumentException	Los parámetros que se han pasado a este método no son válidos. Por ejemplo, son de un tipo o formato no válido.
InvalidOperationException	Para las operaciones de envío se llama el método Execute() desde un controlador de eventos para el evento Loading.
SEHException	Un código no administrado arrojó un error de controlador estructurado de excepciones (SEH) que no ha sido asignado a una excepción de código administrado equivalente. Para obtener más información, busque excepciones no administradas" y "controlador estructurado de excepciones" en la Biblioteca de MSDN.

Comentarios

Al diseñar una plantilla de formulario, puede usar los comandos Acciones de envío de la pestaña Datos para definir el destino del envío y la configuración relacionada que se almacenan en el archivo de definición de solución (.xsf). También puede usar el comando Conexiones de datos de la pestaña Datos para definir la configuración para el envío o recepción de datos, que también se almacena en el archivo de definición de solución (.xsf). Si usa el método Execute() se lleva a cabo una operación de envío o consulta en la conexión de datos utilizando esta configuración definida declarativamente.

El método DataConnection.Execute lo heredan todas las clases que representan conexiones de datos y se expone como método heredado de la clase, por ejemplo, el método EmailSubmitConnection.Execute(). Dependiendo del tipo de conexión de datos que represente la clase que lo hereda, el método Execute llevará a cabo la operación de envío o consulta declarada correspondiente a dicha conexión.

Clase	Operation
AdoQueryConnection	Consultar
AdoSubmitConnection	Enviar
BdcQueryConnection	Consultar
BdcSubmitConnection	Enviar
EmailSubmitConnection	Enviar
FileQueryConnection	Consultar
FileSubmitConnection	Enviar
SharePointListRWQueryConnection Nota La clase SharepointListQueryConnection utilizada en las versiones anteriores de InfoPath ha sido suplantada.	Consultar
WebServiceConnection	Enviar o consultar

Únicamente se puede acceder a este miembro con formularios que se ejecuten en el mismo dominio que el formulario que está actualmente abierto o con formularios a los que se hayan concedido permisos entre dominios.

Se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler o en un explorador web.

Ejemplos

En el siguiente ejemplo, después de usar la propiedad Command de la clase ADOQueryConnection para actualizar el texto del comando SQL de la conexión de datos, se usa el método Execute de la clase DataConnection para ejecutar la consulta para actualizar los datos en el formulario.

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

Vea también

Referencia

clase DataConnection

Miembros DataConnection

Espacio de nombres Microsoft.Office.InfoPath