Skip to content

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 Value storage and synchronizes it with the underlying System.Web.UI.WebControls.TextBox at render time.
  • Handles the TextBox.TextChanged 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
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 a TextChanged event 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()/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\AutoBindTextbox.vb