---
title: AutoBindWebMaskEdit
summary: API reference for AutoBindWebMaskEdit.
status: draft
owner: SAIF documentation generator
last_reviewed: 2026-08-17
library: SAIF.Presentation.Web.Controls.AJAX.Infragistics103
reference_type: package
---

# 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](../../business-rules.md#br-ajax-001-auto-bound-controls-display-validation-errors-sourced-from-the-bound-objects-idataerrorinfo) 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`