Skip to content

SAIF.Presentation.Web.Controls.AJAX.Infragistics103 operations and processes

This page is the operation catalog and cross-operation hub for this library. Each operation's detailed, step-by-step logic lives in its own page under operations/.

Operation catalog

Operation Intent Trigger Inputs Outputs Rules Tables SQL
Page-wide auto-bind and validate Bind every auto-binding control on a page to the model and aggregate validity Hosting page invokes BindingManager.DataBind() Page.Controls tree, Model object Bound controls, aggregate IsValid/ErrorMessages — — —
Auto-bind an individual control to its bound object Populate a control's value from, and write it back to, a bound business-object property ASP.NET control lifecycle DataBind(), or user postback RootBindingObject, BindSource, BindProperty Control Value populated/written back BR-AJAX-001 — —
Validate a bound control and reflect state Surface the bound object's own validation errors on the control and page Called from BindToControl/BindToObject when auto-validation is enabled IsValid, ErrorMessages Page error label text, control background color BR-AJAX-001 — —
Retrieve help text for a screen field Load a single help-text entry for a given application/reference key Consuming code calls clsHelpText.GetHelpText IDataPortalInfo, application code, reference key value Populated read-only clsHelpText instance — APPLICATION_HELP_MASTER, APPLICATION_HELP_DETAIL SQL-HELP-001
Retrieve all help text entries for an application Bulk-load all help-text entries for an application code Consuming code calls clsHelpTextCollection.GetHelpTexts IDataPortalInfo, application code Populated clsHelpTextCollection — APPLICATION_HELP_MASTER, APPLICATION_HELP_DETAIL SQL-HELP-002
Customize and apply grid column visibility and paging Let end users show/hide UltraWebGrid columns and control paging, with optional persisted preferences Page load (initial grid render) and end-user interaction with the modal popup Target UltraWebGrid, model's GridCustomizers collection, clsPreferences Mutated grid column/paging configuration, optionally persisted preferences BR-AJAX-002, BR-AJAX-003 — —

Process flow diagram

The following diagram visualizes the primary operational flow for page binding and help-text retrieval.

flowchart TD
    Start([Page_Load]) --> BM[BindingManager.DataBind walks Page.Controls]
    BM --> Assign[Assign RootBindingObject to each iAutoBindingControl]
    Assign --> CtrlBind[Control lifecycle invokes each control's own DataBind]
    CtrlBind --> BindCtl[BindToControl reads bound property via reflection]
    BindCtl --> Validate{AutoValidateOnDataBind?}
    Validate -->|Yes| ValidateStep[Validate control against IDataErrorInfo]
    Validate -->|No| Skip([Skip validation])
    ValidateStep --> Style[StyleControl colors background]
    Start2([HoverHelp renders]) --> GetHelp[clsHelpText.GetHelpText retrieves DB row]
    GetHelp --> Render[HoverHelp.Fill renders popup content]

Failure and edge-case behavior

  • If RootBindingObject is Nothing when AutoBindControlAncestor.DataBind() runs, the method returns immediately — binding silently no-ops.
  • If no page control named LblErrorMsg exists, PageErrorLabel resolves to Nothing and BindingUtility.SetObjectValue silently swallows the resulting NotSupportedException — error text is never displayed*.
  • InfragisticsGridCustomizer construction throws ApplicationException if a configured always-visible/always-hidden column key does not exist on the target grid.
  • ModalGridCustomizer.TargetGrid/ObjectBinder property getters throw ApplicationException if the named grid/binder control cannot be resolved via Page.FindControl.
  • clsHelpText/clsHelpTextCollection have no create/update/delete path — any attempt to Save()/Delete() an instance raises ApplicationException(BOC.Messages.InvalidSQLProperty) at the point the base class reads the corresponding SQL property.

Note: Statements marked with * were inferred from code structure, naming conventions, or contextual evidence where direct confirmation was not available in source artifacts. Statements marked with ** could not be confirmed; treat as unknown until verified.

Sources

  • SAIF.Presentation.Web.Controls.AJAX.Infragistics103\BindingManager.vb
  • SAIF.Presentation.Web.Controls.AJAX.Infragistics103\AutoBindControlAncestor.vb
  • SAIF.Presentation.Web.Controls.AJAX.Infragistics103\BindingUtility.vb
  • SAIF.Presentation.Web.Controls.AJAX.Infragistics103\clsHelpText.vb
  • SAIF.Presentation.Web.Controls.AJAX.Infragistics103\clsHelpTextCollection.vb
  • SAIF.Presentation.Web.Controls.AJAX.Infragistics103\InfragisticsGridCustomizer.vb
  • SAIF.Presentation.Web.Controls.AJAX.Infragistics103\ModalGridCustomizer.vb
  • SAIF.Presentation.Web.Controls.AJAX.Infragistics103\GridCustomizationPanel.vb