Error Provider Groups

Navigation:  Components >

Error Provider Groups

Previous pageReturn to chapter overviewNext page

Overview

 

Error providers group is a special type of Error Provider component which allows for grouping of several error providers which can be then used as one to employ several ways of error indication simultaneously. Error providers group is a descendant of TNGCsutomErrorProvider and implements DisplayError method by sequential calls to DisplayError method of all the Error Providers included in the Providers collection. Maximum of all the values returned by grouped Validators. Error messages from grouped Validators are then dispatched to the Error Providers included into the Providers collection according to their [MinErrorLevel..MaxErrorLevel] ranges. Validation group introduces several properties for controlling validation process (see the table below).

 

As an error provider group is technically an error provider, it can be included into another error providers group. Number of levels of such nesting of error providers groups is not limited. It provides a flexible way to re-use error-indication sets.

 

Warning: Loops should be avoided while nesting error providers groups!

 

Notes: Validation Group component directly supports use of multiple Error Providers with its Providers collection, so use of error provider group for multiple ways of error indication is not mandatory when using Validation Groups. Another alternative to error provider group is TNGErrorProvider component which is an aggregate of several error providers and supports four ways of error indication.

 

Properties

 

Name

Type

Description

Providers

TNGErrorProviders

The collection of Error Providers which are available for error indication. TNGErrorProviders is a descendant of TCollection class, its items are of type TNGErrorProviderItem which descends from TCollectionItem. The main property of TNGErrorProviderItem is Provider of TNGCustomErrorProvider type which can refer to an Error Provider or an Error Providers Group component.

 

 

See also

 

Validation Group, TNGErrorProvider