namedRecordset method

[This documentation is preliminary and is subject to change.]

Retrieves the recordset object corresponding to the named data member from a data source object (DSO).

Syntax


IDispatch retVal = object.namedRecordset(dataMember, hierarchy);

Standards information

There are no standards that apply here.

Parameters

dataMember [in]

Type: BSTR

BSTR that specifies the name of the data member, or an empty string, which indicates the default data member.

hierarchy [in, optional]

Type: VARIANT

Address of a VARIANT of type VT_BSTR that specifies a path to a hierarchical data set. May be set to NULL.

Remarks

Valid names for a data member are specific to the DSO implementation. Check the DSO documentation to determine whether it supports named data members and to determine the valid names for those data members.

If NULL values or empty strings are passed to the IHTMLGenericElement::namedRecordset method, the default recordset is returned. This is identical to referring to the IHTMLGenericElement::recordset property directly.

If the second parameter is omitted, the top-level recordset is returned. If the first parameter is omitted but the second parameter is specified, the specified subchapter of the default recordset is returned.

See also

Using a Data Source Object that Exposes Multiple Data Members

 

 

Build date: 6/12/2012

Community Additions

Show: