LoadingEventArgs.InputParameters Propriété

Référence

Définition

Espace de noms:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient un qui contient tous les paramètres d’entrée IDictionary spécifiés à l’aide de l’option de ligne de commande /InputParameters, des paramètres de requête dans une URL ou l’une des méthodes NewFromFormTemplateWithInputParameters .

public:
 abstract property System::Collections::Generic::IDictionary<System::String ^, System::String ^> ^ InputParameters { System::Collections::Generic::IDictionary<System::String ^, System::String ^> ^ get(); };

public abstract System.Collections.Generic.IDictionary<string,string> InputParameters { get; }

member this.InputParameters : System.Collections.Generic.IDictionary<string, string>

Public MustOverride ReadOnly Property InputParameters As IDictionary(Of String, String)

Valeur de propriété

IDictionary<String,String>

qui contient des IDictionary paramètres d’entrée.

Exceptions

InvalidOperationException

Une méthode qui a tenté d'écrire dans l'objet IDictionary contenant des paramètres d'entrée a été appelée.

Exemples

Dans l’exemple de code suivant, le modèle de formulaire InfoPath qui contient le code du Loading gestionnaire d’événements est ouvert à partir de la ligne de commande ou d’une URL à l’aide de la syntaxe suivante.

Ligne de commande :

infopath.exe « C :\User Forms\DeptReport.xsn » /InputParameters « Dept=Accounting&Acct=Contoso »

URL:

http://server/sites/team/forms/DeptReport.xsn?Dept=Accounting& Acct=Contoso

Vous pouvez également ouvrir le nouveau formulaire et passer des paramètres d’entrée à partir du code à l’aide de la NewFromFormTemplateWithInputParameters(String, String) méthode de la XmlFormCollection classe , de la NewFromSolutionWithInputParameters(String, String) méthode de l’interface ExternalApplication ou de la NewFromSolutionWithInputParameters(Object, Object) méthode du XDocumentsCollection.

Remarque : Les deux dernières méthodes sont conçues pour être utilisées à partir de code d’automatisation externe et ne peuvent pas être appelées à partir du code de formulaire.

La propriété InputParameters est utilisée à partir d’un gestionnaire d’événements Loading pour définir la valeur du champ Department sur « Comptabilité » et la valeur du champ Compte sur « Contoso » lorsque le formulaire est ouvert. Les paires nom/valeur qui spécifient les valeurs peuvent être passées en tant que paramètres d’entrée à l’aide de l’option de ligne de commande /InputParameters, du paramètre d’entrée d’URL ou NewFromFormTemplateWithInputParameters(String, String) de la méthode .

public void FormEvents_Loading(object sender, LoadingEventArgs e)
{
   // Be sure that the InputParameter dictionary contains
   // values before proceeding.
   if (e.InputParameters.Count != 0)
   {
      string vDept = e.InputParameters["Dept"];
      string vAcct = e.InputParameters["Acct"];

      XPathNavigator myNav = CreateNavigator();
      myNav.SelectSingleNode("/my:myFields/my:Department",
         NamespaceManager).SetValue(vDept);
      myNav.SelectSingleNode("/my:myFields/my:Account",
         NamespaceManager).SetValue(vAcct);
   }
}

  Public Sub FormEvents_Loading(ByVal sender As Object, _
   ByVal e As LoadingEventArgs)
   ' Be sure that the InputParameter dictionary contains
   ' values before proceeding.
   If e.InputParameters.Count &lt;&gt; 0 Then
      Dim vDept As String = e.InputParameters("Dept")
      Dim vAcct As String = e.InputParameters("Acct")
      Dim myNav As XPathNavigator  = CreateNavigator()
      myNav.SelectSingleNode("/my:myFields/my:Department", _
         NamespaceManager).SetValue(vDept)
      myNav.SelectSingleNode("/my:myFields/my:Account", _
         NamespaceManager).SetValue(vAcct)
   End If
End Sub

Remarques

Les paramètres d’entrée se composent d’une ou plusieurs paires nom/valeur séparées par le caractère esperluette (&) spécifié lorsqu’un modèle de formulaire est ouvert à partir de la ligne de commande ou d’un fichier de commandes à l’aide de l’option de ligne de commande /InputParameters. Les paramètres d'entrée peuvent être également spécifiés à l'aide de paramètres de requête lors de l'ouverture d'un modèle de formulaire à partir d'une URL.

Remarque : Alors qu’un IDictionary est normalement en lecture/écriture, InfoPath empêche les appels à toutes les méthodes qui écrivent dans IDictionary (telles que les méthodes Add ou Clear ). Toute tentative d'appel visant à écrire dans un objet IDictionary renvoyé par la propriété InputParameters génère une exception InvalidOperationException.

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.

S’applique à

Partager via