View.ExecuteAction 메서드 (ActionType, String)
양식의 원본으로 사용하는 XML 문서에 대해 특정 필드 또는 그룹을 기초로 편집 명령을 실행합니다.
네임스페이스: Microsoft.Office.InfoPath
어셈블리: Microsoft.Office.InfoPath(Microsoft.Office.InfoPath.dll)
구문
‘선언
Public MustOverride Sub ExecuteAction ( _
action As ActionType, _
xmlToEdit As String _
)
‘사용 방법
Dim instance As View
Dim action As ActionType
Dim xmlToEdit As String
instance.ExecuteAction(action, xmlToEdit)
public abstract void ExecuteAction(
ActionType action,
string xmlToEdit
)
매개 변수
- action
형식: Microsoft.Office.InfoPath.ActionType
실행할 작업을 지정하는 ActionType 열거형입니다.
- xmlToEdit
형식: System.String
편집 작업을 적용할 필드 또는 그룹의 ViewContext 식별자입니다.
예외
| 예외 | 조건 |
|---|---|
| InvalidOperationException | ExecuteAction 메서드가 Loading 이벤트에 대한 이벤트 처리기에서 호출되었습니다. |
| ArgumentNullException | 이 메서드에 전달된 매개 변수가 Null 참조(Visual Basic의Nothing )입니다. |
| ArgumentException | 이 메서드에 전달된 매개 변수가 유효하지 않습니다. 예를 들면 유형이나 형식이 잘못되었습니다. |
주의
ExecuteAction 메서드는 양식의 원본으로 사용하는 XML 문서에 대해 보기에서 선택된 컨텍스트를 기초로 기본 제공 편집 작업을 프로그래밍 방식으로 실행하는 데 사용됩니다.
실행되는 작업은 동일한 메뉴나 도구 모음 단추를 클릭할 때 사용되는 작업과 같습니다. 즉, .xsf 파일의 button 요소가 해당 xmlToEdit 및 action 특성을 가지는 작업이 실행됩니다. 단추를 사용할 때처럼 이 작업은 현재 선택 영역을 기반으로 선택한 컨텍스트에서 수행되며 선택 영역의 특성상 해당 단추가 비활성화되는 경우 ExecuteAction 메서드는 영향을 주지 않습니다.
컨트롤의 속성 대화 상자를 표시한 후 고급 탭을 클릭하면 디자인 모드에서 InfoPath 양식의 컨트롤 또는 그룹에 대한 ViewContext 식별자를 확인할 수 있습니다.
.gif "참고 사항") 참고 사항 |
|---|
경우에 따라 보기에 있는 단추의 Clicked 이벤트에 대한 이벤트 처리기에서 ExecuteAction 메서드를 호출할 때 오류가 발생할 수 있습니다. 이는 단추를 클릭하면 선택 컨텍스트가 단추로 변경되기 때문입니다. 이 경우에는 사용자 지정 작업창, 메뉴 또는 도구 모음의 단추나 링크를 사용하여 ExecuteAction 메서드를 호출하는 것이 좋습니다. |
이 멤버는 현재 열려 있는 양식과 같은 도메인에서 실행하는 양식 또는 도메인 간 권한이 부여된 양식에서만 액세스할 수 있습니다.
이 형식 또는 멤버는 Microsoft InfoPath Filer에서 연 양식에서 실행되는 코드에서만 액세스할 수 있습니다.
예
다음 예제에서는 View 클래스의 ExecuteAction(action, xmlToEdit) 메서드를 통해 ActionType.XCollectionInsert 작업을 실행하여 지정된 그룹에 데이터를 삽입합니다.
this.CurrentView.ExecuteAction(ActionType.XCollectionInsert,
"group1_1");
Me.CurrentView.ExecuteAction(ActionType.XCollectionInsert, "group1_1")