Compartilhar via


DataConnection.Execute Método

Definição

Dependendo da classe ConnectionTypeConnection da qual é chamada, executa uma operação de envio ou consulta na conexão de dados usando os valores definidos declarativamente para os dados enviados, parâmetros de consulta ou dados a serem recuperados.

public:
 abstract void Execute();
public abstract void Execute ();
abstract member Execute : unit -> unit
Public MustOverride Sub Execute ()

Exceções

Falha na operação de execução.

Os parâmetros passados para esse método são uma referência nula (Nada no Visual Basic).

Os parâmetros passados para esse método não são válidos. Por exemplo, eles são do tipo ou formato errado.

Para operações de envio, o Execute() método foi chamado de um manipulador de eventos para o Loading evento.

Um erro de SEH (manipulador de exceção estruturado) foi gerado do código não gerenciado que não é mapeado para uma exceção de código gerenciada equivalente. Para obter mais informações, pesquise em "exceções não gerenciadas" e "Tratamento de exceção estruturada" no Biblioteca MSDN.

Exemplos

No exemplo a seguir, depois que a propriedade Command da classe ADOQueryConnection for usada para atualizar o texto de comando SQL da conexão de dados, o método Execute da DataConnection classe é usado para executar a consulta para atualizar os dados no formulário.

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

Comentários

Ao criar um modelo de formulário, você pode usar os comandos Enviar Ações na guia Dados para definir o destino para enviar e configurações relacionadas que são armazenadas no arquivo de definição de solução do arquivo de modelo de formulário (.xsf). Você também pode usar o comando Data Connections na guia Dados para definir as configurações para enviar ou receber dados, que são armazenados no arquivo de definição de solução (.xsf). O uso do Execute() método executa uma operação de envio ou consulta na conexão de dados usando essas configurações definidas declarativamente.

O método DataConnection.Execute é herdado por todas as classes que representam conexões de dados e é exposto como um método herdado dessa classe, como o método EmailSubmitConnection.Execute(). Dependendo do tipo de conexão de dados que a classe herdada representa, o método Execute executará a operação de envio ou consulta declarada apropriada para essa conexão.

AdoQueryConnection Consultar
AdoSubmitConnection Enviar
BdcQueryConnection Consultar
BdcSubmitConnection Enviar
EmailSubmitConnection Enviar
FileQueryConnection Consultar
FileSubmitConnection Enviar
SharePointListRWQueryConnectionObservaçãoA SharepointListQueryConnection classe usada em versões anteriores do InfoPath foi preterida.Consultar
WebServiceConnection Enviar ou consultar

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed from code running in forms opened in Microsoft InfoPath Filler or in a Web browser.

Aplica-se a