clsDataListBinder

clsDataListBinder binds controls inside a DataList item template to properties of the row's data item, using a control-naming convention rather than a single fixed control reference.

Purpose

• Resolve item-template controls by a configurable prefix convention (default "bound_") so a single binder definition applies across every repeated DataList item.*

Context

• Namespace: SAIF.Presentation.Web.Binding
• Assembly/package: SAIF.Presentation.Web.Binding.Infragistics111 (ILMerged into SAIF.Presentation.Web.Infragistics111.dll)
• Base class: clsObjectBinderBase

Public members

Member	Signature	Purpose
Init	Public Overrides Sub Init()	Subscribes to the relevant item-template control's change event per the standard contract, scoped per DataList item.* Overrides clsObjectBinderBase.Init.
ObjectToControl	Public Overrides Function ObjectToControl() As Boolean	Writes the row's property value into the matching prefixed control within each DataList item.* Overrides clsObjectBinderBase.ObjectToControl.
ControlToObject	Public Overrides Function ControlToObject() As Boolean	Reads the value back from the matching prefixed control within each DataList item.* Overrides clsObjectBinderBase.ControlToObject.

Inherited public members

Members in this section are inherited from clsObjectBinderBase. They are available on this type through inheritance.

Member	Signature	Purpose	Origin
BindSource	Public Property BindSource() As Object	The business object (or collection) this binder reads and writes. Setting it also sets the binder's validation source unless dual binding overrides it (BR-BIND-002).	SAIF.Presentation.Web.Binding.Infragistics111 — clsObjectBinderBase
BindProperty	Public Property BindProperty() As String	Name of the property on BindSource this binder gets/sets by reflection.	SAIF.Presentation.Web.Binding.Infragistics111 — clsObjectBinderBase
FormControl	Public Property FormControl() As Control	The ASP.NET/Infragistics control instance this binder targets; its UniqueID is the key used by clsObjectBindManager.Binder and Update lookups.	SAIF.Presentation.Web.Binding.Infragistics111 — clsObjectBinderBase
BindType	Public Property BindType() As BindTypes	Controls which directions data moves for this binder — ObjectToControl, ControlToObject, TwoWay, or ValidateOnly (BR-BIND-010).	SAIF.Presentation.Web.Binding.Infragistics111 — clsObjectBinderBase
UseEvents	Public Property UseEvents() As Boolean	Whether this binder subscribes to its control's change event in Init (BR-BIND-007, BR-BIND-008).	SAIF.Presentation.Web.Binding.Infragistics111 — clsObjectBinderBase
ValidationKey	Friend Overridable ReadOnly Property ValidationKey() As String	Computes the key under which this binder's validation object is registered — the business object's MyGuid for SAIF framework objects (via IsSAIFFrameWorkObject) or its type name otherwise (BR-BIND-004).	SAIF.Presentation.Web.Binding.Infragistics111 — clsObjectBinderBase
IsSAIFFrameWorkObject	Friend Overridable ReadOnly Property IsSAIFFrameWorkObject() As Boolean	Walks the bind source's runtime base-class chain for the names clsBusinessBase / clsBusinessCollectionBase to decide whether framework-specific keying and validation applies (BR-BIND-061).	SAIF.Presentation.Web.Binding.Infragistics111 — clsObjectBinderBase
GetObjectValueAsString	Protected Function GetObjectValueAsString() As String	Reads BindProperty from BindSource through TypeDescriptor/PropertyDescriptor and the property's TypeConverter, applying configured padding, for display in simple-value controls (BR-BIND-012, BR-BIND-013).	SAIF.Presentation.Web.Binding.Infragistics111 — clsObjectBinderBase
SetObjectValueAsString	Protected Sub SetObjectValueAsString(inValue As String)	Writes a string value back onto BindProperty. Computes a padded value for PadTarget.Object but assigns the unpadded value to the property, so object-side padding has no observable effect.*	SAIF.Presentation.Web.Binding.Infragistics111 — clsObjectBinderBase
GetErrors	Public Overridable Function GetErrors() As Boolean	Selects the validation property/source for a dual binder (otherwise the bind property/source), casts it to IDataErrorInfo, and reads Item(property) to populate ControlErrors (BR-BIND-031, BR-BIND-032, BR-BIND-033).	SAIF.Presentation.Web.Binding.Infragistics111 — clsObjectBinderBase
ControlErrors	Public ReadOnly Property ControlErrors() As ArrayList	The list of non-blank, CRLF-split, <BR>-stripped error message fragments harvested for this binder in the current validation pass.	SAIF.Presentation.Web.Binding.Infragistics111 — clsObjectBinderBase
SetControlFormat	Public Sub SetControlFormat(inValid As Boolean)	Applies error or valid CSS/color styling to FormControl based on control kind — errorbordercolor/errorbackcolor when invalid (BR-BIND-037, BR-BIND-038), normal/defaultbackcolor when valid, honoring an existing disabledbackcolor class (BR-BIND-039, BR-BIND-040).	SAIF.Presentation.Web.Binding.Infragistics111 — clsObjectBinderBase
SetDualBinding	Friend Sub SetDualBinding(inValidationSource As Object, inValidationProperty As String)	Records a validation object/property distinct from the bind object/property, so the control can display one object while validating another (BR-BIND-059).	SAIF.Presentation.Web.Binding.Infragistics111 — clsObjectBinderBase

Behavioral notes

• The inBoundControlPrefix naming convention (default "bound_") is not documented in source beyond the default value; the exact resolution algorithm for locating item-template controls could not be fully traced.*

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. Statements marked with † were retrieved from dependency library documentation via the Legends CLI RAG service. They describe inherited behavior from the indicated origin library and should be verified if the dependency version changes.

Sources

• SAIF.Presentation.Web.Binding.Infragistics111/ASPControls/clsDataListBinder.vb