AutoBindTextbox¶
AutoBindTextbox is the auto-binding TextBox wrapper of this library's binding family. It stores its bound value as a String, renders a standard ASP.NET TextBox, and writes edits back to the bound business object on postback via Auto-bind an individual control to its bound object.
Purpose¶
- Provides string-typed
Valuestorage and synchronizes it with the underlyingSystem.Web.UI.WebControls.TextBoxat render time. - Handles the
TextBox.TextChangedpostback 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 |
|---|---|---|
| Value | Overrides Property Value() As Object |
The control's string value, backed by m_Text; synchronized to the rendered TextBox.Text |
| Textbox_TextChanged | Overridable Sub Textbox_TextChanged(sender As Object, e As System.EventArgs) |
Handles the inner TextBox's TextChanged postback event, updates Value, and calls BindToObject() to persist the edit onto the bound object |
| StyleControl | Overrides Sub StyleControl(inValid As Boolean) |
Colors the inner TextBox background red when invalid, or resets it to default when valid |
| OverrideFocus | Sub OverrideFocus() |
No-op placeholder method with no observable effect* |
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 textbox 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 |
| HeaderText | Property HeaderText() As String |
Header caption text made available to concrete subclasses for hover/label rendering | SAIF.Presentation.Web.Controls.AJAX.Infragistics103 — AutoBindControlAncestor |
| HelpText | Property HelpText() As String |
Help text made available to concrete subclasses for hover/label rendering | SAIF.Presentation.Web.Controls.AJAX.Infragistics103 — AutoBindControlAncestor |
Behavioral notes¶
- The initial bogus value
"VALUE_NOT_INITIALIZED"is used to guarantee aTextChangedevent 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()/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\AutoBindTextbox.vb