DataConnection.Execute Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.
public:
abstract void Execute();
public abstract void Execute();
abstract member Execute : unit -> unit
Public MustOverride Sub Execute ()
Excepciones
Error de la operación de recuperación.
Los parámetros pasados a este método son una referencia nula (Nothing en Visual Basic).
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.
Para las operaciones de envío, se llamó al Execute() método desde un controlador de eventos para el Loading evento.
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.
Ejemplos
En el ejemplo siguiente, después de usar la propiedad Command de la clase ADOQueryConnection para actualizar el texto del comando SQL de la conexión de datos, el método Execute de la DataConnection clase se usa para ejecutar la consulta para actualizar los datos del 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
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). El uso del Execute() método realiza una operación de envío o consulta en la conexión de datos mediante esta configuración definida mediante declaración.
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 | Consulta |
| AdoSubmitConnection | Enviar |
| BdcQueryConnection | Consulta |
| BdcSubmitConnection | Enviar |
| EmailSubmitConnection | Enviar |
| FileQueryConnection | Consulta |
| FileSubmitConnection | Enviar |
| SharePointListRWQueryConnectionNotaLa SharepointListQueryConnection clase usada en versiones anteriores de InfoPath ha quedado en desuso. | Consulta |
| 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.