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

# AutoBindWebDateTimeEdit

`AutoBindWebDateTimeEdit` is the auto-binding wrapper over the Infragistics `WebDateTimeEdit` control. It stores its bound value as a `Date`, formats it as `MM/dd/yyyy` in both display and edit modes, and additionally implements `IProvidesEmbeddableEditor` so it can be embedded as a cell editor inside other Infragistics controls (e.g., grid cells).

## Purpose
- Provides date-typed `Value` storage and synchronizes it with the underlying `WebDateTimeEdit.Date` property at render time.
- Handles the `WebDateTimeEdit.ValueChange` postback event to push the user's edited date back onto the bound business object and re-validate.
- Implements `Infragistics.WebUI.Shared.IProvidesEmbeddableEditor` so Infragistics grid/cell hosts can embed this control as a date editor.

## Context
- Namespace: `SAIF.Presentation.Web.Controls.V2.AJAX`
- Assembly/package: `SAIF.Presentation.Web.Controls.AJAX.Infragistics103`

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| Value | `Overrides Property Value() As Object` | The control's `Date` value, backed by `m_value`; synchronized to the rendered `WebDateTimeEdit.Date` |
| Textbox_TextChanged | `Overridable Sub Textbox_TextChanged(sender As Object, e As Infragistics.WebUI.WebDataInput.ValueChangeEventArgs)` | Handles the inner `WebDateTimeEdit`'s `ValueChange` postback event, updates `Value`, and calls `BindToObject()` to persist the edit |
| StyleControl | `Overrides Sub StyleControl(inValid As Boolean)` | Colors the inner `WebDateTimeEdit` background red when invalid, or resets it to default when valid |
| CanEditType | `Function CanEditType(type As System.Type) As Boolean` | Delegates to the inner `WebDateTimeEdit` to report whether it can edit the given CLR type |
| CanRenderType | `Function CanRenderType(type As System.Type) As Boolean` | Delegates to the inner `WebDateTimeEdit.CanEditType` to report whether it can render the given CLR type |
| EditorClientID | `ReadOnly Property EditorClientID() As String` | Client-side identifier a hosting Infragistics grid/cell uses to locate and script the embedded editor |
| EditorID | `ReadOnly Property EditorID() As String` | Server-side identifier a hosting Infragistics grid/cell uses to locate the embedded editor control |
| RenderValue | `Function RenderValue(value As Object) As String` | Delegates to the inner `WebDateTimeEdit.RenderValue` to format a value for embedded display |

## 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 `Date.MaxValue` is used to guarantee a `ValueChange` event fires the first time the control is data-bound and the user makes any edit*.
- Contains an unused private helper `GetLastFocus` that searches for a control with ID `__LASTFOCUS`; it has no observable callers in this file*.

## 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\AutoBindWebDateTimeEdit.vb`