ContentListFactory.CreateNewContentList Method (PIA)
Use this method to create a new ContentList object based on the schema established for this ContentListFactory object. The new ContentList object provides a unified interface to the private data that it stores and to the shared data stored in the ContentListFactory object (that created it).
Definition
[Visual Basic .NET]
Imports Microsoft.CommerceServer.Interop.Caching
…
Public Function CreateNewContentList() As IContentList
[C#]
using Microsoft.CommerceServer.Interop.Caching;
…
public IContentList CreateNewContentList();
Return Values
[Visual Basic .NET] If this method completes successfully, it returns a reference to an object that implements the IContentList interface.
[C#] This method returns an IContentList interface to a new ContentList object.
Exceptions
This method may throw one of many mapped exceptions or an exception of type COMException. See Standard COM Errors for additional details.
Remarks
The new ContentList object will be based on the established schema for this ContentListFactory object. Storage for columns marked as CLCOL_PRIVATE in the schema is allocated in the ContentList object. The ContentList object maintains a pointer back to the factory that created it, which is where the storage for "shared" columns is maintained.
A ContentList object cannot exist independently of a ContentListFactory object.
The only prerequisite for calling this method is that a schema must be established. This can be accomplished by setting the Schema property or by calling the ConstructFromRecordset method.
[Visual Basic .NET]
Example
oMyContentList = myContentListFactory.CreateNewContentList()
See Also
Copyright © 2005 Microsoft Corporation.
All rights reserved.