New to Telerik Reporting? Start a free 30-day trial

DataItem

Class

Internal use only

Definition

Assembly:Telerik.Reporting.dll

Syntax:

public abstract class DataItem : ReportItem, IToggleVisibilityTarget, IActionTarget, IDataItem, IDataFlow, IDataSourceContainer

Inheritance: objectReportObjectReportItemBaseReportItemDataItem

Derived Classes: GraphLinearGaugeMapRadialGaugeTable

Implements: IActionTargetIDataFlowIDataItemIDataSourceContainerIToggleVisibilityTarget

Inherited Members ReportItem.SizeReportItem.LocationReportItem.AnchoringReportItem.DockingReportItem.BoundsReportItem.LeftReportItem.RightReportItem.TopReportItem.BottomReportItem.WidthReportItem.HeightReportItem.DefaultSizeReportItemBase.Dispose()ReportItemBase.Dispose(bool)ReportItemBase.ToString()ReportItemBase.Contains(ReportItemBase)ReportItemBase.GetEventHandlers(EventHandler)ReportItemBase.OnItemValidate(ReportItemBase)ReportItemBase.ClearGlobalDependencies()ReportItemBase.ContainerReportItemBase.DesignModeReportItemBase.SiteReportItemBase.NameReportItemBase.ItemDataBindingMethodNameReportItemBase.ItemDataBoundMethodNameReportItemBase.VisibleReportItemBase.StyleNameReportItemBase.StyleReportItemBase.ItemsReportItemBase.ParentReportItemBase.ReportReportItemBase.ConditionalFormattingReportItemBase.BookmarkReportItemBase.BookmarkIdReportItemBase.DocumentMapTextReportItemBase.TocTextReportItemBase.TocLevelReportItemBase.ActionReportItemBase.BindingsReportItemBase.ToolTipReportItemBase.AccessibleDescriptionReportItemBase.AccessibleRoleReportItemBase.AIDescriptionReportItemBase.ItemDataBindingReportItemBase.ItemDataBoundReportItemBase.DisposedReportObject.ToString(string[])...

Constructors

DataItem()

Internal use only

public DataItem()

Properties

DataSource

object

Gets or sets the data source that the DataItem (e.g., Table, Graph, Map) is displaying data for.

[TypeConverter(typeof(DataSourceConverter))]
[AIAssistantRename("DataSourceName")]
[AIAssistantByRef("/DataSources")]
[AIAssistantRequired]
public virtual object DataSource { get; set; }

Property Value:

An object that functions as a data source.

Implements: IDataSourceContainer.DataSource

Remarks:

Telerik Reporting includes dedicated data source components that enable retrieving and feeding all data items from various sources. See all the available data source components at: https://docs.telerik.com/reporting/designing-reports/connecting-to-data/data-source-components/overview

For convenience, all the objects applicable to the DataSource property can be directly assigned to this DataSource property. At runtime, the report engine will wrap them in an ObjectDataSource to resolve the actual data.

Filters

FilterCollection

Gets a FilterCollection that defines the filter expression(s) for the Table

public FilterCollection Filters { get; }

Property Value:

FilterCollection that contains the Filter objects for the Table

Remarks:

Filter expressions limit the data that is displayed to the user after the data is retrieved from the data source.

NeedDataSourceMethodName

string

Gets or sets the name of the method that should be called when the NeedDataSource event is triggered.

[AIAssistantExclude("")]
public string NeedDataSourceMethodName { get; set; }

Property Value:

A string value identifying the name of the method from the source assembly.

NoDataMessage

string

Internal use only

public string NoDataMessage { get; set; }

NoDataStyle

Style

TODO: Add documentation.

[TypeConverter(typeof(ExpandableObjectConverter))]
public Style NoDataStyle { get; }

Sorting

SortingCollection

Internal use only

[Browsable(false)]
[Obsolete("Please use Sortings property instead.")]
public SortingCollection Sorting { get; }

Sortings

SortingCollection

Gets a SortingCollection that defines the sort column(s), and their type and order for the Table

public SortingCollection Sortings { get; }

Property Value:

A SortingCollection that contains the Sorting objects for the Table

Remarks:

Sort expressions sort the data that is displayed to the user after the data is retrieved from the data source.

Methods

OnNeedDataSource(object, EventArgs)

Internal use only

protected virtual void OnNeedDataSource(object sender, EventArgs e)

Parameters:senderobjecteEventArgs

Events

NeedDataSource

EventHandler

Occurs when the processing of a DataItem instance begins, and the instance does not have its DataSource property set.

public event EventHandler NeedDataSource

Remarks:

This event is attached to the definition-level DataItem instance, but the sender in the event handler is the processing-level DataItem instance. The processing instance inherits its DataSource from the definition, and if neither has a DataSource set, this event is raised.