Свойство LoadingEventArgs.InputParameters

Статья
04/27/2010

Возвращает объект IDictionary, содержащий любые входные параметры, определенные с помощью параметра командной строки /InputParameters или параметров запроса в URL-адресе.

Пространство имен: Microsoft.Office.InfoPath
Сборка: Microsoft.Office.InfoPath (в microsoft.office.infopath.dll)

Синтаксис

'Декларация
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; }

Значение свойства

Объект IDictionary, содержащий входные параметры.

Исключения

Тип исключения	Условие
InvalidOperationException	Был вызван метод, который пытался выполнить запись в объект IDictionary, содержащий входные параметры.

Заметки

Входные параметры состоят из одной или нескольких пар имя/значение, разделенных знаком амперсанда (&), которые определяются при открытии шаблона формы из командной строки или пакетного файла с помощью параметра командной строки /InputParameters. Входные параметры также можно указать с помощью параметров запроса при открытии шаблона формы из URL-адреса.

Заметка
Хотя IDictionary обычно поддерживает чтение и запись, InfoPath запрещает вызовы любых методов, выполняющих запись в IDictionary (таких как методы Add или Clear). Любые попытки выполнить запись в IDictionary с помощью вызова метода, возвращенные свойством InputParameters, вызовут InvalidOperationException.

Хотя IDictionary обычно поддерживает чтение и запись, InfoPath запрещает вызовы любых методов, выполняющих запись в IDictionary (таких как методы Add или Clear). Любые попытки выполнить запись в IDictionary с помощью вызова метода, возвращенные свойством InputParameters, вызовут InvalidOperationException.

Доступ к этому члену имеется только у форм, запускаемых на том же домене, что и открытая в настоящий момент форма, или у форм, которым были присвоены междоменные разрешения.

Доступ к этому типу или члену имеется из программы, работающей в формах, открытых в Microsoft Office InfoPath 2007 или в веб-обозревателе.

Пример

В следующем примере шаблон формы InfoPath открывается из командной строки или URL-адреса с помощью следующего синтаксиса.

Командная строка:

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

URL-адрес:

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

Свойство InputParameters используется из обработчика события Loading, чтобы задать в поле Department значение "Accounting", которое передается с помощью параметра командной строки /InputParameters или входного параметра 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

См. также

Ссылка

Класс LoadingEventArgs
Члены LoadingEventArgs
Пространство имен Microsoft.Office.InfoPath

Поделиться через