LoadingEventArgs.InputParameters Eigenschaft

Referenz

Definition

Namespace:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft eine IDictionary ab, die alle Eingabeparameter enthält, die mithilfe der /InputParameters-Befehlszeilenoption, Abfrageparametern in einer URL oder einer der NewFromFormTemplateWithInputParameters-Methoden angegeben werden.

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)

Eigenschaftswert

IDictionary<String,String>

Ein IDictionary , das Eingabeparameter enthält.

Ausnahmen

InvalidOperationException

Es wurde eine Methode aufgerufen, durch die versucht wurde, in das IDictionary-Objekt zu schreiben, das Eingabeparameter enthält.

Beispiele

Im folgenden Codebeispiel wird die InfoPath-Formularvorlage, die den Loading Ereignishandlercode enthält, über die Befehlszeile oder eine URL mit der folgenden Syntax geöffnet.

Befehlszeile:

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

URL:

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

Alternativ können Sie das neue Formular öffnen und Eingabeparameter aus dem Code übergeben, indem Sie die NewFromFormTemplateWithInputParameters(String, String) -Methode der XmlFormCollection -Klasse, die NewFromSolutionWithInputParameters(String, String) -Methode der ExternalApplication -Schnittstelle oder die NewFromSolutionWithInputParameters(Object, Object) -Methode von XDocumentsCollectionverwenden.

Hinweis: Die letzten beiden Methoden sind für die Verwendung aus externem Automatisierungscode konzipiert und können nicht über Formularcode aufgerufen werden.

Die InputParameters-Eigenschaft wird aus einem Loading Ereignishandler verwendet, um den Wert des Department-Felds auf "Accounting" und den Wert des Kontofelds auf "Contoso" festzulegen, wenn das Formular geöffnet wird. Die Name-Wert-Paare, die die Werte angeben, können als Eingabeparameter mit der Befehlszeilenoption /InputParameters, dem URL-Eingabeparameter oder NewFromFormTemplateWithInputParameters(String, String) der Methode übergeben werden.

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

Hinweise

Eingabeparameter bestehen aus einem oder mehreren Name-Wert-Paaren, die durch das kaufmännische und -Zeichen (&) getrennt sind, die angegeben werden, wenn eine Formularvorlage über die Befehlszeile oder eine Batchdatei mithilfe der Befehlszeilenoption /InputParameters geöffnet wird. Eingabeparameter können auch mithilfe von Abfrageparametern angegeben werden, wenn eine Formularvorlage über eine URL geöffnet wird.

Hinweis: Während ein IDictionary normalerweise Lese-/Schreibzugriff hat, verhindert InfoPath Aufrufe von Methoden, die in das IDictionary schreiben (z. B. die Add- oder Clear-Methode ). Bei sämtlichen Aufrufversuchen, die Schreibvorgänge auf IDictionary (Rückgabe erfolgt über die InputParameters-Eigenschaft) ausführen, wird InvalidOperationException ausgelöst.

Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.

Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.

Gilt für:

Freigeben über