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

# AutoBindWebMaskEdit

`AutoBindWebMaskEdit` is the auto-binding wrapper around an Infragistics `WebMaskEdit`, used for masked-input fields (e.g. formatted numbers or codes) that need the same reflection-based bind/validate/style pipeline as the other auto-bind editors. It exposes the underlying `WebMaskEdit` and its `InputMask` directly, so callers can configure the mask in markup while the ancestor handles model binding.

## Purpose
- Wraps an Infragistics `WebMaskEdit` so masked-input values participate in the shared auto-binding, validation, and styling pipeline via [AutoBindControlAncestor](AutoBindControlAncestor.md).
- Exposes `InputMask` so the mask pattern can be configured per instance while binding behavior stays uniform across all auto-bind editors.
- Captures a user's edited masked value on the editor's change event and immediately writes it back to the bound model property. ([BR-AJAX-007](../../business-rules.md#br-ajax-007-a-user-edit-is-captured-and-pushed-to-the-model-immediately))

## Context
- Namespace: `SAIF.Presentation.Web.Controls.V2.AJAX`
- Assembly/package: `SAIF.Presentation.Web.Controls.AJAX.Infragistics111` (packaged in `SAIF.BOF.Presentation.Web.Infragistics111`)
- Base class: [AutoBindControlAncestor](AutoBindControlAncestor.md)

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| `WebMaskEdit` | `ReadOnly Property WebMaskEdit As Infragistics.WebUI.WebDataInput.WebMaskEdit` | The underlying Infragistics masked-edit control this class wraps |
| `InputMask` | `Property InputMask As String` | The mask pattern applied to the underlying `WebMaskEdit` |
| `Textbox_TextChanged` | `Sub Textbox_TextChanged(sender As Object, e As EventArgs)` | Copies the masked editor's current text into `Value`, then calls `BindToObject` and, if `AutoValidate`, `Validate()` ([BR-AJAX-007](../../business-rules.md#br-ajax-007-a-user-edit-is-captured-and-pushed-to-the-model-immediately), [BR-AJAX-006](../../business-rules.md#br-ajax-006-controls-validate-automatically-after-bind-and-edit-unless-disabled)) |

## Inherited public members

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

| Member | Signature | Purpose | Origin |
| --- | --- | --- | --- |
| `AutoPostback` | `Property AutoPostback As Boolean` | Controls whether the inner editor posts back on change | `SAIF.Presentation.Web.Controls.AJAX.Infragistics111` — `AutoBindControlAncestor` |
| `AutoBind` | `Property AutoBind As Boolean` | Enables or disables participation in `BindingManager.DataBind` | `SAIF.Presentation.Web.Controls.AJAX.Infragistics111` — `AutoBindControlAncestor` |
| `AutoValidate` | `Property AutoValidate As Boolean` (default `True`) | Enables automatic validation after a user edit | `SAIF.Presentation.Web.Controls.AJAX.Infragistics111` — `AutoBindControlAncestor` |
| `AutoValidateOnDataBind` | `Property AutoValidateOnDataBind As Boolean` (default `True`) | Enables automatic validation after data binding | `SAIF.Presentation.Web.Controls.AJAX.Infragistics111` — `AutoBindControlAncestor` |
| `RootBindingObject` | `Property RootBindingObject As Object` | The page model instance assigned by `BindingManager` | `SAIF.Presentation.Web.Controls.AJAX.Infragistics111` — `AutoBindControlAncestor` |
| `BoundObject` | `ReadOnly Property BoundObject As Object` | Object resolved by walking `BindSource` from `RootBindingObject` | `SAIF.Presentation.Web.Controls.AJAX.Infragistics111` — `AutoBindControlAncestor` |
| `BindSource` | `Property BindSource As String` | Dotted model path to `BoundObject` | `SAIF.Presentation.Web.Controls.AJAX.Infragistics111` — `AutoBindControlAncestor` |
| `BindProperty` | `Property BindProperty As String` | Name of the property on `BoundObject` this control reads/writes | `SAIF.Presentation.Web.Controls.AJAX.Infragistics111` — `AutoBindControlAncestor` |
| `Value` | `Property Value As Object` | The editor's current value | `SAIF.Presentation.Web.Controls.AJAX.Infragistics111` — `AutoBindControlAncestor` |
| `DataBind` | `Overrides Sub DataBind()` | Binds the model value into the control | `SAIF.Presentation.Web.Controls.AJAX.Infragistics111` — `AutoBindControlAncestor` |
| `StyleControl` | `Sub StyleControl(inValid As Boolean)` | Paints the editor red when invalid, resets it otherwise | `SAIF.Presentation.Web.Controls.AJAX.Infragistics111` — `AutoBindControlAncestor` |
| `Validate` | `Function Validate() As Boolean` | Runs validation and updates the page error label | `SAIF.Presentation.Web.Controls.AJAX.Infragistics111` — `AutoBindControlAncestor` |
| `RootObject` | `ReadOnly Property RootObject As Object` | The hosting page's `Model` property value | `SAIF.Presentation.Web.Controls.AJAX.Infragistics111` — `SAIFAJAXControlAncestor` |

## Behavioral notes
- All bind/validate behavior comes unchanged from `AutoBindControlAncestor`; this class only supplies the concrete Infragistics `WebMaskEdit` and its change-event wiring.

## Constraints and usage notes
- `Infragistics35.WebUI.WebDataInput.v11.1` (version 11.1.20111.2090) must be available in the hosting application for `WebMaskEdit` to render.
- Because `StyleControl` and `Validate` are inherited unchanged, the same `LblErrorMsg` naming contract applies. ([BR-AJAX-011](../../business-rules.md#br-ajax-011-validation-messages-are-written-to-the-pages-lblerrormsg-label))

## Related documentation
- [Index](../../index.md)
- [Overview](../../overview.md)
- [Architecture](../../architecture.md)
- [Business rules](../../business-rules.md)
- [API reference](../index.md)

## Sources
- `SAIF.Presentation.Web.Controls.AJAX.Infragistics111/AutoBindWebMaskEdit.vb`
