다음을 통해 공유


LoadingEventArgs.InputParameters 속성

/InputParameters 명령줄 옵션을 사용하여 지정하거나 URL에서 쿼리 매개 변수를 사용하여 지정한 입력 매개 변수가 있는 IDictionary을 가져옵니다.

네임스페이스: 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 메서드 등)를 호출할 수 없습니다. InputParameters 속성에서 반환되는 IDictionary에 쓰기를 수행하는 호출을 시도하면 InvalidOperationException가 발생합니다.

이 멤버는 현재 열려 있는 양식과 같은 도메인에서 실행하는 양식 또는 도메인 간 권한이 부여된 양식에서만 액세스할 수 있습니다.

이 형식 또는 구성원은 Microsoft Office InfoPath 2007 또는 웹 브라우저에서 연 양식에서 실행되는 코드에서만 액세스할 수 있습니다.

예제

다음 예제에서는 다음 구문을 사용하여 명령줄이나 URL에서 InfoPath 양식 서식 파일을 엽니다.

명령줄:

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

URL:

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

InputParameters 속성은 Loading 이벤트 처리기에서 Department 필드 값을 /InputParameters 명령줄 옵션이나 URL 입력 매개 변수를 통해 전달된 "Accounting" 값으로 설정하는 데 사용됩니다.

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 네임스페이스