LoadingEventArgs.InputParameters-Eigenschaft

Ruft IDictionary mit beliebigen Eingabeparametern ab, die mithilfe der /InputParameters-Befehlszeilenoption oder mithilfe von Abfrageparametern in einem URL angegeben werden.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

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

Dim instance As LoadingEventArgs
Dim value As IDictionary(Of String, String)

value = instance.InputParameters

public abstract IDictionary<string,string> InputParameters { get; }

Eigenschaftswert

IDictionary mit Eingabeparametern.

Ausnahmen

Hinweise

Eingabeparameter bestehen aus mindestens einem durch das kaufmännische Und-Zeichen (&) getrennten Namen-/Wertepaar, das angegeben wird, wenn eine Formularvorlage von der Befehlszeile oder über eine Batchdatei mithilfe der /InputParameters-Befehlszeilenoption geöffnet wird. Eingabeparameter können auch mithilfe von Abfrageparametern angegeben werden, wenn eine Formularvorlage von einem URL geöffnet wird.

Hinweis:
Während IDictionary in der Regel über Lese-/Schreibzugriff verfügt, werden von InfoPath Aufrufe sämtlicher Methoden vermieden, die einen Schreibvorgang auf IDictionary ausführen (z. B. die Methoden Add oder Clear). Bei sämtlichen Aufrufversuchen, die Schreibvorgänge auf IDictionary (Rückgabe erfolgt über die InputParameters-Eigenschaft) ausführen, wird InvalidOperationException ausgelöst.

Auf den Member kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das zurzeit geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.

Auf diesen Typ oder diesen Member kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft Office InfoPath 2007 oder einem Webbrowser geöffnet wurden.

Beispiel

Im folgenden Beispiel wird mithilfe der folgenden Syntax eine InfoPath-Formularvorlage entweder von der Befehlszeile aus oder über die URL geöffnet.

Befehlszeile:

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

URL:

https://server/sites/team/forms/DeptReport.xsn?Dept=Accounting

Die InputParameters-Eigenschaft wird von einem Loading-Ereignishandler verwendet, um den Feldwert Abteilung auf den mithilfe der /InputParameters-Befehlszeilenoption übergebenen Wert "Buchhaltung" oder mithilfe des URL-Eingabeparameters festzulegen.

public void FormEvents_Loading(object sender, LoadingEventArgs e)
{
   string vDept = e.InputParameters["Dept"];

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

Public Sub FormEvents_Loading(ByVal sender As Object, _
   ByVal e As LoadingEventArgs)
   Dim vDept As String = e.InputParameters("Dept")

   Dim myNav As XPathNavigator  = CreateNavigator()
   myNav.SelectSingleNode("/my:myFields/my:Department",
      NamespaceManager).SetValue(vDept)
End Sub

Siehe auch

Referenz

LoadingEventArgs-Klasse
LoadingEventArgs-Member
Microsoft.Office.InfoPath-Namespace