FormErrorCollection.Delete method (FormError)

Office 2013 and later

Deletes the specified FormError from the FormErrorCollection object associated with the current form.

Namespace:  Microsoft.Office.InfoPath
Assembly:  Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)

public abstract void Delete(
	FormError formError
)

Parameters

formError
Type: Microsoft.Office.InfoPath.FormError

The FormError to delete.

ExceptionCondition
ArgumentException

The error is not of type FormErrorType.UserDefined.

ArgumentException

The error is not in the collection.

ArgumentNullException

The parameter passed to this method is a null reference (Nothing in Visual Basic).

ArgumentException

The parameter passed to this method is not valid. For example, it is of the wrong type or format.

Only errors of type ErrorType.UserDefined can be deleted from the collection. If the specified error is not user-defined, or is not in the collection, an exception is thrown.

This member can be accessed without restrictions.

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

In the following example, the GetErrors(FormErrorType) method of the FormErrorCollection class is used to get an array of all user-defined errors in the form's error collection. Then, the Delete(formError) method is used to delete the first FormError object in the array from the form's error collection.

FormErrorCollection myErrors = this.Errors;
FormError[] myUserErrors;

// Get all user defined errors.
myUserErrors = myErrors.GetErrors(FormErrorType.UserDefined);

// Delete the first user defined error.
myErrors.Delete(myUserErrors[0]);
Show: