---
title: clsWebComboBinder
summary: API reference for clsWebComboBinder.
status: draft
owner: SAIF Doc Gen
last_reviewed: 2026-08-17
library: SAIF.Presentation.Web.Binding.Infragistics111
reference_type: package
---

# clsWebComboBinder

`clsWebComboBinder` binds an Infragistics `WebCombo` control's selected value to a business-object property.

## Purpose
- Bind a `WebCombo` control's selection to a business-object property, similarly to `clsDDLBinder` but for the richer Infragistics combo control.*

## 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 combo's selection-changed event per the standard contract.* Overrides `clsObjectBinderBase.Init`. |
| ObjectToControl | `Public Overrides Function ObjectToControl() As Boolean` | Assigns the list data source and selects/writes the bound value into the combo control.* Overrides `clsObjectBinderBase.ObjectToControl`. |
| ControlToObject | `Public Overrides Function ControlToObject() As Boolean` | Writes the combo's selected 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](../../business-rules.md#br-bind-002-bindsource-sets-validation-source)). | `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](../../business-rules.md#br-bind-010-databind-and-bindtoobject-respect-bind-type)). | `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](../../business-rules.md#br-bind-007-change-event-subscription-requires-useevents), [BR-BIND-008](../../business-rules.md#br-bind-008-change-event-subscription-requires-write-back-bind-type)). | `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](../../business-rules.md#br-bind-004-validation-object-registered-once-by-key)). | `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](../../business-rules.md#br-bind-061-framework-object-detected-by-base-class-name)). | `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](../../business-rules.md#br-bind-012-object-values-read-via-typeconverter), [BR-BIND-013](../../business-rules.md#br-bind-013-padding-applied-before-display)). | `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](../../business-rules.md#br-bind-031-dual-binder-validates-its-validation-pair), [BR-BIND-032](../../business-rules.md#br-bind-032-error-text-split-and-br-stripped), [BR-BIND-033](../../business-rules.md#br-bind-033-non-empty-error-text-flags-control)). | `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](../../business-rules.md#br-bind-037-error-styling-by-control-type), [BR-BIND-038](../../business-rules.md#br-bind-038-grids-never-styled-at-control-level)), `normal`/`defaultbackcolor` when valid, honoring an existing `disabledbackcolor` class ([BR-BIND-039](../../business-rules.md#br-bind-039-disabled-controls-not-restyled-on-success), [BR-BIND-040](../../business-rules.md#br-bind-040-valid-styling-by-control-type)). | `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](../../business-rules.md#br-bind-059-dual-binding-separates-bind-and-validation-pairs)). | `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/InfragisticsClassicControls/clsWebComboBinder.vb
