Proprietà LoadingEventArgs.InputParameters

Articolo
04/27/2010

Ottiene un oggetto IDictionary contenente eventuali parametri di input specificati utilizzando l'opzione /InputParameters della riga di comando o utilizzando parametri di query in un URL.

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

Sintassi

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; }

Valore proprietà

Oggetto IDictionary contenente i parametri di input.

Eccezioni

Tipo eccezione	Condizione
InvalidOperationException	È stato chiamato un metodo tramite il quale è stato eseguito un tentativo di scrittura nell'oggetto IDictionary contenente parametri di input.

Osservazioni

I parametri di input sono costituiti da una o più coppie nome/valore separate dal carattere e commerciale (&) specificate quando un modello di modulo viene aperto dalla riga di comando o da un file batch utilizzando l'opzione /InputParameters della riga di comando. I parametri di input possono inoltre essere specificati utilizzando parametri di query quando un modello di modulo viene aperto da un URL.

Nota:
Mentre un oggetto IDictionary è in genere impostato in lettura e scrittura, in InfoPath non sono consentite le chiamate a metodi che comportano la scrittura nell'oggetto IDictionary, ad esempio i metodi Add o Clear. Eventuali tentativi di eseguire chiamate che comportano la scrittura nell'oggetto IDictionary restituito dalla proprietà InputParameters generano un'eccezione InvalidOperationException.

Mentre un oggetto IDictionary è in genere impostato in lettura e scrittura, in InfoPath non sono consentite le chiamate a metodi che comportano la scrittura nell'oggetto IDictionary, ad esempio i metodi Add o Clear. Eventuali tentativi di eseguire chiamate che comportano la scrittura nell'oggetto IDictionary restituito dalla proprietà InputParameters generano un'eccezione InvalidOperationException.

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 viene aperto un modello di modulo di InfoPath dalla riga di comando o dall'URL utilizzando la sintassi seguente:

Riga di comando:

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

URL:

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

La proprietà InputParameters viene utilizzata da un gestore eventi Loading per impostare il valore del campo Department sul valore "Accounting" che è stato passato utilizzando l'opzione della riga di comando /InputParameters o il parametro di input dell'URL.

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

Vedere anche

Riferimenti

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

Condividi tramite