Metodo DataConnection.Execute

In base alla classe ConnectionTipoConnessione da cui viene chiamato, esegue un'operazione di invio o di query nella connessione dati utilizzando i valori definiti in modo dichiarativo per i dati inviati, i parametri di query o i dati da recuperare.

Spazio dei nomi: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Sintassi

Public MustOverride Sub Execute

Dim instance As DataConnection

instance.Execute

public abstract void Execute ()

Eccezioni

Tipo eccezione	Condizione
WebException	L'esecuzione non è riuscita.

Osservazioni

Quando si progetta un modello di modulo, è possibile utilizzare il comando Opzioni invio modulo del menu Strumenti per definire la destinazione dell'operazione di invio e le impostazioni correlate archiviate nel file di definizione della soluzione, con estensione xsf, del file del modello di modulo. È inoltre possibile utilizzare il comando Connessioni dati del menu Strumenti per definire le impostazioni per l'invio o la ricezione dei dati, anch'esse archiviate nel file di definizione della soluzione. Utilizzando il metodo Execute viene eseguita un'operazione di invio o di query nella connessione dati utilizzando queste impostazioni definite in modo dichiarativo.

Il metodo DataConnection.Execute viene ereditato da tutte le classi che rappresentano connessioni dati e viene esposto come metodo ereditato di tale classe, come ad esempio il metodo EmailSubmitConnection.Execute(). In base al tipo di connessione dati rappresentato dalla classe che eredita il metodo, il metodo Execute eseguirà l'operazione di query o di invio dichiarata appropriata per la connessione.

AdoQueryConnection

Query

AdoSubmitConnection

Invio

EmailSubmitConnection

Invio

FileQueryConnection

Query

FileSubmitConnection

Invio

SharepointListQueryConnection

Query

WebServiceConnection

Invio o query

Possono accedere a questo membro solo moduli eseguiti nello stesso dominio del modulo aperto oppure moduli a cui sono state concesse autorizzazioni tra domini.

A questo tipo o membro può accedere solo il codice in esecuzione in moduli aperti in Microsoft Office InfoPath 2007 o in un browser.

Esempio

Nell'esempio seguente, dopo avere utilizzato la proprietà Command della classe ADOQueryConnection per aggiornare il testo del comando SQL della connessione dati, viene utilizzato il metodo Execute della classe DataConnection per eseguire la query per aggiornare i dati del modulo.

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

Vedere anche

Riferimenti

Classe DataConnection
Membri DataConnection
Spazio dei nomi Microsoft.Office.InfoPath