ContentListFactory Object

Use this object to efficiently maintain lists of content items that compete with each other to be selected for display on a Web page by a Content Selection pipeline (CSP).

ProgID:

Commerce.ContentListFactory (Externally creatable)

COM Class Name:

ContentListFactory

Type Library Name:

Microsoft Commerce Server Cache Manager Type Library

DLL Name:

mscscache.dll

Threading Model:

Both

[C++]

COM Interface Name:

IContentListFactory

Interface ID Constant:

IID_IContentListFactory

Header File:

cacheint.h

In C++, use the IContentListFactory and IDataContainer interfaces to access to the methods and properties of a ContentListFactory object.

Methods

Method

Description

BuildIndex

Builds an index on the specified column.

ConstructFromRecordset

Initializes a ContentListFactory object, and creates and initializes a new ContentListSchema object, from an ADO Recordset object. The ContentListFactory object is populated with the data from the Recordset object.

CreateNewContentList

Creates a new ContentList object based on the schema in use by this ContentListFactory object. The new ContentList object has access to the shared data in the ContentListFactory object that created it.

GetData

Gets data from a specified row and column in a ContentListFactory object in a high-performance, non-scriptable manner.

Search

Returns a RowCollection object containing the collection of content items that match the search criteria.

SetData

Sets data at a specified row and column in a ContentListFactory object in a high-performance, non-scriptable manner.

Properties

Property

Description

AllRows

The collection of all rows in the ContentListFactory object.

This property is read-only.

Count

The number of rows in the ContentListFactory object.

This property is read/write.

Fields

The Fields collection for a particular row in the ContentListFactory object.

This property is read-only.

Schema

Stores a reference to the ContentListSchema object used by this ContentListFactory object.

This property is read/write.

Remarks

Note

The ContentList and the ContentListFactory objects are designed to be run in-process with their clients. The GetData and SetData methods assume direct memory access for performance reasons.

Both the ContentList object and the ContentListFactory object implement a common interface, IDataContainer. Therefore they share the following methods and properties, which are functionally identical on both objects:

Properties:

  • AllRows

  • Count

  • Fields

Methods:

  • BuildIndex

  • GetData

  • Search

  • SetData

See Also

Other Resources

Targeting Objects