IListConsumer Interface
The IListConsumer interface defines methods that a Web Part can implement so that it can consume an entire list (rowset) of data from another Web Part that implements the IListProvider interface.
Public Methods
The following table shows the methods of the IListConsumer interface and a brief description of each.
| Name | Description |
|---|---|
| ListProviderInit | Event handler for the ListProviderInit event of a Web Part that implements the IListProvider interface. |
| ListReady | Event handler for the ListReady event of a Web Part that implements the IListProvider interface. |
| PartialListReady | Event handler for the PartialListReady event of a Web Part that implements the IListProvider interface. |
Thread Safety
Any public static (Shared in Visual Basic) members of this type are safe for multithreaded operations. Instance members are not guaranteed to be thread safe.
Remarks
The IListConsumer interface should be implemented for Web Parts that need to consume a collection of data that can be characterized as a list, such as a table of data. A Web Part that implements the IListConsumer interface has the ability to receive initialization arguments from the provider part. Connecting the IListConsumer to the IListProvider interface is a direct connection, so no transformer dialog is displayed. To use the passed values appropriately, the consuming Web Part may need to be designed with an understanding of the data sent by the provider part.
Example
The following code example is a simple server-side IListConsumer Web Part. It can be connected to another Web Part that implements the IListProvider interface on the server. Its user interface displays the list that it receives from an IListProvider Web Part.
There are 8 steps specific to making this a connectable Web Part. These steps are numbered and commented in the sample code.
For an overview of the steps of creating a connectable Web Part, see Creating a Connectable Web Part.
Requirements
Namespace: Microsoft.SharePoint.WebPartPages.Communication
Platforms: Microsoft Windows Server 2003
Assembly: Windows SharePoint Services (in Microsoft.SharePoint.dll)
Security: Code Access Security