RangeFilterDashboardItem.DateTimePeriods Property

Gets a collection of date-time periods that can be used to select a predefined range in the Range Filter using its context menu.

Namespace: DevExpress.DashboardCommon

Assembly: DevExpress.Dashboard.v18.2.Core.dll

Declaration

C#

public DateTimePeriodCollection DateTimePeriods { get; }

VB.NET

Public ReadOnly Property DateTimePeriods As DateTimePeriodCollection

Property Value

Type	Description
DateTimePeriodCollection	A DateTimePeriodCollection object that is a collection of date-time periods.

Remarks

The RangeFilterDashboardItem class exposes the DateTimePeriods property, providing access to a collection of predefined date-time periods.

To add the required date-time period in code, create the DateTimePeriod class instance and execute the following steps.

• Specify the required boundaries for the created period. To do this, create the FixedDateTimePeriodLimit or FlowDateTimePeriodLimit class objects and specify its settings.
• Pass the specified date-time boundaries to the DateTimePeriod constructor or assign these objects to the DateTimePeriod.Start/DateTimePeriod.End properties.

  Note

  If you do not specify DateTimePeriod.Start/DateTimePeriod.End, the selection will begin from the start/end of the visible range.

• Specify the period name using the DateTimePeriod.Name property.
• Add the resulting DateTimePeriod object to the RangeFilterDashboardItem.DateTimePeriods collection.

If necessary, you can specify the default selected range for the Range Filter. To do this, assign the DateTimePeriod.Name value to the RangeFilterDashboardItem.DefaultDateTimePeriodName property.

Example

This example shows how to create a predefined date-time period for the Range Filter dashboard item.

C#

            RangeFilterDashboardItem rangeFilter = new RangeFilterDashboardItem();
            // ...

            FixedDateTimePeriodLimit startDate = new FixedDateTimePeriodLimit(new System.DateTime(2015, 1, 1));
            FlowDateTimePeriodLimit endDate = new FlowDateTimePeriodLimit(DateTimeInterval.Month, -1);
            DateTimePeriod customPeriod = new DateTimePeriod("Custom period", startDate, endDate);
            rangeFilter.DateTimePeriods.Add(customPeriod); 

VB.NET

            Dim rangeFilter As New RangeFilterDashboardItem()
            ' ...

            Dim startDate As New FixedDateTimePeriodLimit(New System.DateTime(2015, 1, 1))
            Dim endDate As New FlowDateTimePeriodLimit(DateTimeInterval.Month, -1)
            Dim customPeriod As New DateTimePeriod("Custom period", startDate, endDate)
            rangeFilter.DateTimePeriods.Add(customPeriod)