DataConnection.Execute (Método)

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

Tipo de excepción	Condición
WebException	Error de la operación de recuperación.

Comentarios

Al diseñar una plantilla de formulario, puede usar el comando Opciones de envío de formularios del menú Herramientas para definir el destino del envío y la configuración relacionada que se almacena en el archivo de definición de solución (.xsf) del archivo de plantilla de formulario. También puede usar el comando Conexiones de datos del menú Herramientas 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.

AdoQueryConnection

Consultar

AdoSubmitConnection

Enviar

EmailSubmitConnection

Enviar

FileQueryConnection

Consultar

FileSubmitConnection

Enviar

SharepointListQueryConnection

Consultar

WebServiceConnection

Enviar o consultar

Sólo pueden tener acceso a este miembro los formularios que se ejecuten en el mismo dominio que el formulario abierto actualmente o los formularios a los que se hayan concedido permisos entre dominios.

Se puede tener acceso a este tipo o miembro desde un código ejecutado en formularios abiertos en Microsoft Office InfoPath 2007 o en un explorador Web.

Ejemplo

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

DataConnection (Clase)
DataConnection (Miembros)
Microsoft.Office.InfoPath (Espacio de nombres)