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
Valuestorage and synchronizes it with the underlyingWebDateTimeEdit.Dateproperty at render time. - Handles the
WebDateTimeEdit.ValueChangepostback event to push the user's edited date back onto the bound business object and re-validate. - Implements
Infragistics.WebUI.Shared.IProvidesEmbeddableEditorso 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.MaxValueis used to guarantee aValueChangeevent fires the first time the control is data-bound and the user makes any edit*. - Contains an unused private helper
GetLastFocusthat searches for a control with ID__LASTFOCUS; it has no observable callers in this file*.
Constraints and usage notes¶
- Enforces BR-AJAX-001 via its inherited
Validate()/StyleControlbehavior.
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