Skip to content

SAIF.Presentation.Web.Controls.Infragistics103 overview

Documentation context: This library is distributed as part of the SAIF.BOF.Presentation.Web.Infragistics103 NuGet package (source bundled directly, not compiled by this project).

SAIF.Presentation.Web.Controls.Infragistics103 is a presentation-tier ASP.NET WebForms control-extension library that wraps four Infragistics WebUI v10.3 controls to add SAIF-specific client-side behavior — async-refresh error handling and focus restoration, sentinel "null date" suppression, masked-value cleanup, and cascading-dropdown filtering inside an UltraWebGrid — without performing data access, business-object orchestration, or server-side navigation of its own. SAIFWarp does cause client-side browser navigation to the central error page (/weberror/processError.aspx) for qualifying async-refresh errors (BR-4).

Purpose

  • Extend Infragistics v10.3 vendor controls (WebAsyncRefreshPanel, WebDateTimeEdit, WebMaskEdit) and the base ASP.NET Control class with SAIF-specific client-side script injection and value-cleanup behavior, so consuming WebForms pages get consistent async-error handling, date-field, mask-field, and cascading-dropdown behavior without re-implementing it per page.
  • Consumed declaratively by ASP.NET WebForms pages via ToolboxData markup (e.g., <{0}:SAIFWARP runat=server>); no dependency-injection, factory, or service-locator usage is involved.

Responsibilities

  • Centralize async-refresh error redirection and post-refresh focus restoration for panels wrapping WebAsyncRefreshPanel (SAIFWarp).
  • Suppress Infragistics' sentinel "null date" values (01/01/1901, 12/31/9999) from being displayed to users in date fields (SAIFWebDateTimeEdit).
  • Provide cleaned PhoneValue/TaxIdValue accessors that strip mask placeholders and dangling extension markers (SAIFWebMaskEdit).
  • Wire cascading/dependent dropdown value lists on UltraGridColumn instances of an UltraWebGrid, generating client-side JavaScript filters (clsDropDownController).

Key components

  • SAIFWarp: async-refresh panel wrapper with centralized error redirection and focus restoration.
  • clsDropDownController: generic cascading-dropdown binder for two UltraGridColumn value lists.
  • SAIFWebDateTimeEdit: date-edit wrapper that blanks sentinel "no date" values on focus.
  • SAIFWebMaskEdit: mask-edit wrapper exposing cleaned phone/tax-ID value accessors.

Sources

  • SAIF.Presentation.Web.Controls.Infragistics103\SAIF.Presentation.Web.Controls.Infragistics103.vbproj
  • SAIF.Presentation.Web.Controls.Infragistics103\SAIFWarp.vb
  • SAIF.Presentation.Web.Controls.Infragistics103\clsDropDownController.vb
  • SAIF.Presentation.Web.Controls.Infragistics103\SAIFWebDateTimeEdit.vb
  • SAIF.Presentation.Web.Controls.Infragistics103\SAIFWebMaskEdit.vb
  • SAIF.BOF.Presentation.Web.Infragistics103.nuspec