CMSRepeater Class

Repeater control that can be bounded to the CMS content.

Inheritance Hierarchy

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.Repeater
      CMS.ExtendedControls.UIRepeater
        CMS.Controls.BasicRepeater
          CMS.Controls.CMSRepeater
            CMS.Controls.CMSRepeaterWithEffect

Namespace: CMS.Controls
Assembly: CMS.Controls (in CMS.Controls.dll) Version: 9.0.0

Syntax

public class CMSRepeater : BasicRepeater, 
	ICMSDataProperties, ICMSControlProperties, ICMSBaseProperties, IStopProcessing

The CMSRepeater type exposes the following members.

Constructors

	Name	Description
Public method	CMSRepeater()	Constructor.
Public method	CMSRepeater(TreeProvider)	Constructor.

Fields

	Name	Description
Protected field	mControlsLoaded	Flag saying whether the dynamic controls has been loaded yet. (Inherited from BasicRepeater.)
Protected field	mDataLoaded	Flag saying whether the data has been loaded yet. (Inherited from BasicRepeater.)
Protected field	mDataPager	DataPager variable.
Protected field	mDataSource	Document data source.
Protected field	mExternalPager	External pager control?
Protected field	mFilterControl	Filter control.
Protected field	mFilterName	Filter name.
Protected field	mItemSeparator	Item separator code.
Protected field	mOnBeforeInitFired	True if the on before init was fired. (Inherited from BasicRepeater.)
Protected field	mPageSizeSet	Indicates if page size property is set.
Protected field	mRelatedData	Custom data connected to the object. (Inherited from BasicRepeater.)
Protected field	mRelatedDataLoaded	Related data is loaded. (Inherited from BasicRepeater.)
Protected field	NoData	When DataSource is empty NoData = true
Protected field	useDataSourceControl	Indicates whether the viewer should obtain data source from the referenced control provided by the value of DataSourceControl property. (Inherited from BasicRepeater.)

Properties

	Name	Description
Public property	AlternatingTransformationName	Transformation name in format application.class.transformation applied to alternating items.
Public property	CacheDependencies	Cache dependencies, each cache dependency on a new line.
Public property	CacheItemName	Name of the cache item the control will use.
Public property	CacheMinutes	Number of minutes the retrieved content is cached for. Zero indicates that the content will not be cached.
Public property	CategoryName	Property to set and get the category name for filtering documents.
Public property	ClassNames	Property to set and get the classnames list (separated by the semicolon).
Public property	Columns	Gets or sets the columns to be retrieved from database.
Public property	CombineWithDefaultCulture	Property to set and get the CombineWithDefaultCulture flag.
Public property	ControlContext	Control context.
Public property	CultureCode	Property to set and get the CultureCode.
Public property	DataBindByDefault	Indicates whether data binding should be performed by default. (Inherited from BasicRepeater.)
Public property	DataSource	Object from which data-bound control retrieves its list of data item. (Inherited from BasicRepeater.)
Public property	DataSourceControl	Control with data source. (Inherited from BasicRepeater.)
Public property	DataSourceName	Gets or sets name of source. (Inherited from BasicRepeater.)
Protected property	DefaultDataSource	Default data source to use if no external is provided (Overrides BasicRepeater.DefaultDataSource.)
Public property	DelayedLoading	Indicates whether the data should be loaded to the load event instead of default init event.
Public property	EnablePaging	Enables paging on Data control
Public property	FilterControl	Filter control.
Public property	FilterName	Gets or Set filter name.
Public property	FilterOutDuplicates	Indicates if the duplicated (linked) items should be filtered out from the data.
Public property	HideControlForZeroRows	Hides the control when no data is loaded. Default value is False. (Inherited from BasicRepeater.)
Public property	CheckPermissions	Allows you to specify whether to check permissions of the current user. If the value is 'false' (default value) no permissions are checked. Otherwise, only nodes for which the user has read permission are displayed.
Public property	IsSelected	Gets a value indicating whether the current item is a selected item.
Public property	ItemSeparator	Item separator between displayed records.
Public property	LoadPagesIndividually	If true, each page is loaded individually in case of paging.
Public property	MaxRelativeLevel	Property to set and get the MaxRelativeLevel.
Public property	NestedControlsID	Nested controls ID, use ';' like separator.
Public property	OrderBy	Property to set and get the OrderBy.
Public property	PageableControl	Gets or sets the encapsulated control that implements IUniPageable interface. (Inherited from BasicRepeater.)
Public property	PagerControl	Represents pager control.
Public property	PagerDataItem	Pager data item object. (Inherited from BasicRepeater.)
Public property	PagerForceNumberOfResults	Gets or sets the number of result. Enables proceed "fake" datasets, where number of results in the dataset is not correspondent to the real number of results This property must be equal -1 if should be disabled (Inherited from BasicRepeater.)
Public property	PageSize	Number of items per page.
Public property	ParentControl	Parent control.
Public property	Path	Property to set and get the Path.
Public property	RelatedData	Custom data connected to the object, if not set, returns the Related data of the nearest IDataControl. (Inherited from BasicRepeater.)
Public property	RelatedNodeIsOnTheLeftSide	If true, the returned nodes are on the right side of the relationship.
Public property	RelationshipName	Name of the relationship.
Public property	RelationshipWithNodeGuid	Select nodes with given relationship with given node.
Public property	ResolveDynamicControls	Gets or sets the value that indicates whether dynamic controls should be resolved (Inherited from BasicRepeater.)
Public property	SelectedColumns	Gets or sets the columns to be retrieved from database.
Public property	SelectedItemTransformationName	Transformation name for selected item in format application.class.transformation.
Public property	SelectOnlyPublished	Property to set and get the SelectOnlyPublished flag.
Public property	SelectTopN	Top N rows to select.
Public property	ShortID	Short ID of the control. (Inherited from UIRepeater.)
Public property	ShowDeleteButton	Show Delete button.
Public property	ShowEditButton	Show Edit and Delete buttons.
Public property	ShowEditDeleteButtons	Show Edit and Delete buttons.
Public property	SiteName	Property to set and get the SiteName.
Public property	StopProcessing	Stop processing
Public property	TopN	Select top N rows.
Public property	TransformationName	Transformation name in format application.class.transformation.
Public property	TreeProvider	Tree provider instance used to access data. If no TreeProvider is assigned, a new TreeProvider instance is created.
Public property	UniPagerControl	Pager control. (Inherited from BasicRepeater.)
Public property	WhereCondition	Property to set and get the WhereCondition.
Public property	ZeroRowsText	Text to be shown when the control is hidden by HideControlForZeroRows. (Inherited from BasicRepeater.)

Methods

	Name	Description
Protected method	BoundPagerToDataSource	Bound pager to the external external DataSource (Inherited from BasicRepeater.)
Public method	ClearCache	Clears the cached items.
Protected method	CreateControlHierarchy	Creates a control hierarchy with or without the specified datasource. (Inherited from BasicRepeater.)
Public method	DataBind	Databind event. (Overrides BasicRepeater.DataBind().)
Public method	GetDefaultCacheDependencies	Gets the default cache dependencies for the data source.
Public method	HasData	Indicates if datasource contains data. (Inherited from BasicRepeater.)
Protected method	InitControl	Ensures default data binding (Overrides BasicRepeater.InitControl(Boolean).)
Protected method	OnInit	Init event handler. (Inherited from BasicRepeater.)
Protected method	OnLoad	OnLoad event handler (Inherited from BasicRepeater.)
Protected method	OnPreRender	OnPreRender override. (Inherited from BasicRepeater.)
Protected method	RaiseOnBeforeInit	Raises the OnBeforeInit event. (Inherited from BasicRepeater.)
Public method	ReBind	Evokes control databind. (Inherited from BasicRepeater.)
Public method	ReleaseContext	Releases the web part context.
Public method	ReloadData	Loads data from the according to the current values of properties. (Overrides BasicRepeater.ReloadData(Boolean).)
Protected method	ReloadDataInternal	Loads data from the according to the current values of properties.
Protected method	Render	Render event handler. (Overrides BasicRepeater.Render(HtmlTextWriter).)
Public method	SetContext	Sets the web part context.

Extension Methods

	Name	Description
Public Extension Method	CallHandled	Calls the method handled by the exception handler. If the call doesn't succeed, the problem is reported through parent IExceptionHandler control instead of throwing unhandled exception for the entire page. Returns true, if the call succeeded, otherwise returns false. (Defined by ControlsExtensions.)
Public Extension Method	GetString	Gets the string by the specified resource key (Defined by ControlsExtensions.)

Events

	Name	Description
Public event	OnBeforeInit	On before init handler. (Inherited from BasicRepeater.)
Public event	OnPageBinding	Occurs when the control bind data. (Inherited from BasicRepeater.)
Public event	OnPageChanged	Occurs when the pager change the page and current mode is postback => reload data (Inherited from BasicRepeater.)