AutoBindWebMaskEdit

AutoBindWebMaskEdit is the auto-binding wrapper over the Infragistics WebMaskEdit control. It stores its bound value as a String, applies a configurable input mask (e.g., for phone numbers or SSNs) to the underlying editor, and writes edits back to the bound business object on postback.

Purpose

• Provides string-typed Value storage and synchronizes it, plus an InputMask string, with the underlying WebMaskEdit at render time.
• Handles the WebMaskEdit.ValueChange postback event to push the user's edited text back onto the bound business object and re-validate.

Context

• Namespace: SAIF.Presentation.Web.Controls.V2.AJAX
• Assembly/package: SAIF.Presentation.Web.Controls.AJAX.Infragistics103

Public members

Member	Signature	Purpose
InputMask	Property InputMask() As String	The input-mask pattern applied to the underlying WebMaskEdit (e.g., a phone-number or SSN mask)
WebMaskEdit	ReadOnly Property WebMaskEdit() As Infragistics.WebUI.WebDataInput.WebMaskEdit	Exposes the underlying Infragistics editor control instance for advanced host customization
Value	Overrides Property Value() As Object	The control's string value, backed by m_Text; synchronized to the rendered WebMaskEdit.Text
Textbox_TextChanged	Overridable Sub Textbox_TextChanged(sender As Object, e As Infragistics.WebUI.WebDataInput.ValueChangeEventArgs)	Handles the inner WebMaskEdit's ValueChange postback event, updates Value, and calls BindToObject() to persist the edit
StyleControl	Overrides Sub StyleControl(inValid As Boolean)	Colors the inner WebMaskEdit background red when invalid, or resets it to default when valid

Inherited public members

Members in this section are inherited from AutoBindControlAncestor in SAIF.Presentation.Web.Controls.AJAX.Infragistics103. They are available on this type through inheritance.

Member	Signature	Purpose	Origin
BindSource	Property BindSource() As String	Dotted property path identifying the bound object relative to RootBindingObject	SAIF.Presentation.Web.Controls.AJAX.Infragistics103 — AutoBindControlAncestor
BindProperty	Property BindProperty() As String	Name of the property on BoundObject this control reads/writes	SAIF.Presentation.Web.Controls.AJAX.Infragistics103 — AutoBindControlAncestor
RootBindingObject	Property RootBindingObject() As Object	The page model object from which BoundObject is resolved	SAIF.Presentation.Web.Controls.AJAX.Infragistics103 — AutoBindControlAncestor
AutoPostback	Property AutoPostback() As Boolean	Controls whether the editor posts back immediately on value change	SAIF.Presentation.Web.Controls.AJAX.Infragistics103 — AutoBindControlAncestor
AutoBind	Property AutoBind() As Boolean	Indicates whether the control participates in automatic page-wide binding	SAIF.Presentation.Web.Controls.AJAX.Infragistics103 — AutoBindControlAncestor
AutoValidate	Property AutoValidate() As Boolean	Controls whether Validate() runs after BindToObject()	SAIF.Presentation.Web.Controls.AJAX.Infragistics103 — AutoBindControlAncestor
AutoValidateOnDataBind	Property AutoValidateOnDataBind() As Boolean	Controls whether Validate() runs after DataBind()	SAIF.Presentation.Web.Controls.AJAX.Infragistics103 — AutoBindControlAncestor
IsBound	ReadOnly Property IsBound() As Boolean	Guard that determines whether the control has a live target to participate in binding/validation, gating DataBind()/Validate() from acting on an unresolved object	SAIF.Presentation.Web.Controls.AJAX.Infragistics103 — AutoBindControlAncestor
IsValid	ReadOnly Property IsValid() As Boolean	Validity status consumed by Validate()/StyleControl to color the control and by BindingManager to aggregate page-wide validity; reflects whether the bound object currently reports any IDataErrorInfo errors for BindProperty	SAIF.Presentation.Web.Controls.AJAX.Infragistics103 — AutoBindControlAncestor
ErrorMessages	ReadOnly Property ErrorMessages() As String()	The bound object's current validation errors for BindProperty	SAIF.Presentation.Web.Controls.AJAX.Infragistics103 — AutoBindControlAncestor
DataBind	Overrides Sub DataBind()	Runs the full bind cycle against the bound object	SAIF.Presentation.Web.Controls.AJAX.Infragistics103 — AutoBindControlAncestor
Validate	Overridable Function Validate() As Boolean	Surfaces validation errors and restyles the control	SAIF.Presentation.Web.Controls.AJAX.Infragistics103 — AutoBindControlAncestor

Behavioral notes

• The initial bogus value "VALUE_NOT_INITIALIZED" is used to guarantee a ValueChange event fires the first time the control is data-bound and the user makes any edit*.

Constraints and usage notes

• Enforces BR-AJAX-001 via its inherited Validate()/StyleControl behavior.

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\AutoBindWebMaskEdit.vb