FormErrorCollection.Add 메서드 (XPathNavigator, String, String, String)

아티클
09/24/2014

새 FormError를 만들어 현재 양식과 연결된 FormErrorCollection 개체에 추가합니다.

네임스페이스: Microsoft.Office.InfoPath
어셈블리: Microsoft.Office.InfoPath(Microsoft.Office.InfoPath.dll)

구문

‘선언
Public MustOverride Function Add ( _
    context As XPathNavigator, _
    name As String, _
    message As String, _
    messageDetails As String _
) As FormError
‘사용 방법
Dim instance As FormErrorCollection
Dim context As XPathNavigator
Dim name As String
Dim message As String
Dim messageDetails As String
Dim returnValue As FormError

returnValue = instance.Add(context, name, _
    message, messageDetails)

public abstract FormError Add(
    XPathNavigator context,
    string name,
    string message,
    string messageDetails
)

매개 변수

context
형식: System.Xml.XPath.XPathNavigator
오류를 연결할 노드에 배치되는 XPathNavigator 개체입니다.

name
형식: System.String
오류 이름이며 비워 둘 수 없습니다.

message
형식: System.String
간단한 오류 메시지입니다.

messageDetails
형식: System.String
자세한 오류 메시지입니다.

반환 값

형식: Microsoft.Office.InfoPath.FormError
컬렉션에 추가된 새 FormError에 대한 참조입니다.

예외

예외	조건
ArgumentException	name이 Null 참조(Visual Basic의Nothing )이거나 빈 문자열입니다.
ArgumentException	이름이 같은 오류가 컬렉션에 이미 있습니다.
ArgumentNullException	이 메서드에 전달된 매개 변수가 Null 참조(Visual Basic의Nothing )입니다.
ArgumentException	이 메서드에 전달된 매개 변수가 유효하지 않습니다. 예를 들면 유형이나 형식이 잘못되었습니다.

주의

새 FormError의 FormErrorType은 UserDefined로 설정됩니다.

참고 사항
name 매개 변수 값이 같은 여러 개의 오류를 서로 다른 context 노드에 추가할 수 있습니다. 그러나 이름이 같은 오류를 같은 context 노드에 두 번 추가하면 두 번째 오류가 첫 번째 오류를 덮어씁니다.

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

이 형식 또는 멤버는 Microsoft InfoPath Filer 또는 웹 브라우저에서 연 양식에서 실행되는 코드에서 액세스할 수 있습니다.

예

다음 예제에서는 먼저 오류를 연결할 필드에 XPathNavigator 개체를 배치한 후, XPathNavigator, 이름, 메시지 및 자세한 메시지를 FormErrorCollection 클래스의 Add 메서드에 전달하여 양식의 오류 모음에 오류를 추가합니다.

XPathNavigator root, txtbox;
// Create XPathNavigator for main data source.
root = this.MainDataSource.CreateNavigator();

// Create XPathNavigator positioned at field to associate with error.
txtbox = root.SelectSingleNode("//my:field1", this.NamespaceManager);

// Get form's collection of errors and add error.
this.Errors.Add(txtbox, "Field1Error", "Short error message.", 
   "Detailed error description.", 102057, ErrorMode.Modeless);

Dim root, txtbox As XPathNavigator
' Create XPathNavigator for main data source.
root = Me.MainDataSource.CreateNavigator()

' Create XPathNavigator positioned at field to add error.
txtbox = root.SelectSingleNode("//my:field1", Me.NamespaceManager)

' Get form's collection of errors and add error.
Me.Errors.Add(txtbox, "Field1Error", "Short error message.", 
   "Detailed error description.", 102057, ErrorMode.Modeless)