EmailSubmitConnection.Execute - Méthode (XPathNavigator)

Article
05/11/2015

Ignore la méthode Execute par défaut pour autoriser l'envoi d'une autre source de données.

Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)

Syntaxe

'Déclaration
Public MustOverride Sub Execute ( _
    input As XPathNavigator _
)
'Utilisation
Dim instance As EmailSubmitConnection
Dim input As XPathNavigator

instance.Execute(input)

public abstract void Execute(
    XPathNavigator input
)

Paramètres

input
Type : System.Xml.XPath.XPathNavigator

Objet XPathNavigator positionné sur le nœud XML qui contient les données à envoyer.

Exceptions

Exception	Condition
ArgumentNullException	Le paramètre passé à cette méthode est une référence Null (Rien dans Visual Basic).
ArgumentException	Le paramètre passé à cette méthode n'est pas valide. Par exemple, le type ou le format est incorrect.

Remarques

Cette méthode remplace la méthode Execute() par défaut (héritée de la classe de base DataConnection), qui envoie la source de données principale du formulaire. L'objet XPathNavigator spécifié pour le paramètre input doit pointer vers un nœud XML contenant les données à envoyer. Les données à envoyer peuvent être déterminées par n'importe quel objet DataSource.

L'affectation de la valeur null au paramètre input a le même effet que l'utilisation de la méthode Execute() par défaut pour envoyer tout le formulaire à l'aide des paramètres déclaratifs définis dans le modèle de formulaire.

Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.

Vous pouvez accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler ou dans un navigateur web.

Exemples

L'exemple ci-dessous utilise la méthode Execute(XPathNavigator) pour envoyer le formulaire à la connexion de données « Envoi de courrier électronique » en utilisant les données de la source de données « QueryTypedDataSet » au lieu de la source de données principale du formulaire.

public void FormEvents_Submit(object sender, SubmitEventArgs e)
{
   XmlForm myXmlForm = this;
   XPathNavigator myNav = myXmlForm.DataSources[
      "QueryTypedDataSet"].CreateNavigator();

   EmailSubmitConnection mySubmit = (EmailSubmitConnection)myXmlForm.
      DataConnections["Email Submit"];
   mySubmit.Execute(myNav);
}

Public Sub FormEvents_Submit(ByVal sender As Object, _
   ByVal e As SubmitEventArgs)
   Dim myXmlForm As XmlForm = Me
   Dim myNav As XPathNavigator = myXmlForm.DataSources(_
      "QueryTypedDataSet").CreateNavigator()

   EmailSubmitConnection mySubmit = DirectCast( _
      myXmlForm.DataConnections("Email Submit"),EmailSubmitConnection)
   mySubmit.Execute(myNav)
End Sub

Voir aussi

Référence

EmailSubmitConnection classe

EmailSubmitConnection - Membres

Execute - Surcharge

Microsoft.Office.InfoPath - Espace de noms

Partager via