IHTMLDatabinding::dataSrc Property

Sets or retrieves the source of the data for data binding.

Syntax

HRESULT IHTMLDatabinding::get_dataSrc(BSTR *p);
HRESULT IHTMLDatabinding::put_dataSrc(BSTR v);

Parameters

  • p
    Pointer to a variable of type BSTR that receives the identifier of the data source.
  • v
    BSTR that specifies the identifier of the data source.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

The IHTMLDatabinding::dataFld property is not available on param objects; use getAttribute('dataFld') instead.

Tabular and single-valued data consumers use the IHTMLDatabinding::dataSrc property to specify a binding. The property takes a string that corresponds to the unique identifier of a data source object (DSO) on the page. The string must be prefixed by a number sign (#).

When the IHTMLDatabinding::dataSrc property is applied to a tabular data consumer, the entire data set is repeated by the consuming elements.

When the IHTMLDatabinding::dataSrc property is applied to a table, any contained single-valued consumer objects that specify a IHTMLDatabinding::dataFld property are repeated for each record in the supplied data set. To complete the binding, the binding agent interrogates the enclosing table for its data source. A tabular data consumer contained within another tabular data consumer ( table) must specify an explicit IHTMLDatabinding::dataSrc.

See Also

Introduction to Data Binding