Skip to content

clsDDLBinder

clsDDLBinder binds a DropDownList control's selected value to a business-object property, and is one of the three binder types clsObjectBindManager.Update can re-point at a new data source after a postback.

Purpose

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 drop-down's selection-changed event per the standard contract (BR-BIND-007, BR-BIND-008). Overrides clsObjectBinderBase.Init.
ObjectToControl Public Overrides Function ObjectToControl() As Boolean Assigns the data source to the control's DataSource and calls the control's own DataBind, then selects the item matching the bound value.* Overrides clsObjectBinderBase.ObjectToControl.
ControlToObject Public Overrides Function ControlToObject() As Boolean Writes the selected item's value back onto the bound property.* 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

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/clsDDLBinder.vb