FormErrorCollection.GetErrors Method (String) (Microsoft.Office.InfoPath)

Article
06/23/2010

Returns all FormError objects of the specified name from the FormErrorCollection object associated with the current form.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

'Declaration
Public MustOverride Function GetErrors ( _
    name As String _
) As FormError()
'Usage
Dim instance As FormErrorCollection
Dim name As String
Dim returnValue As FormError()

returnValue = instance.GetErrors(name)

public abstract FormError[] GetErrors (
    string name
)

Parameters

name
The name of the errors to return.

Return Value

An array of type FormError that contains all errors of type FormErrorType.UserDefined with the specified name.

Exceptions

Exception type	Condition
ArgumentNullException	The parameter passed to this method is null.
ArgumentException	The parameter passed to this method isnot valid. For example, it is of the wrong type or format.

Remarks

An empty array is returned if there are no errors in the collection of the specified name.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed from code running in forms opened in Microsoft Office InfoPath 2007 or in a Web browser.

Example

In the following example, the GetErrors method of the FormErrorCollection class is used to get all errors named DateFormatError from the form's errors collection. The Message property of the FormError class is then used to display their error messages.

FormError[] myErrors;
myErrors = this.Errors.GetErrors("DateFormatError");

foreach(FormError err in myErrors)
{
   MessageBox.Show(err.Message);
}

Dim myErrors As FormError()
myErrors = Me.Errors.GetErrors("DateFormatError")

For Each FormError err In myErrors
   MessageBox.Show(err.Message);
Next

Share via