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

아티클
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, _
    errorCode As Integer _
) As FormError
‘사용 방법
Dim instance As FormErrorCollection
Dim context As XPathNavigator
Dim name As String
Dim message As String
Dim messageDetails As String
Dim errorCode As Integer
Dim returnValue As FormError

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

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

매개 변수

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

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

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

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

errorCode
형식: System.Int32
오류 코드입니다.

반환 값

형식: 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);

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)