ResourceStorage.Filter Property

Gets or set an expression used as a criteria to filter resources in the storage.

Namespace: DevExpress.XtraScheduler

Assembly: DevExpress.XtraScheduler.v24.1.dll

NuGet Package: DevExpress.Win.Scheduler

Declaration

C#

[DefaultValue("")]
[XtraSerializableProperty]
public override string Filter { get; set; }

VB.NET

<XtraSerializableProperty>
<DefaultValue("")>
Public Overrides Property Filter As String

Property Value

Type	Default	Description
String	String.Empty	A string containing a logical expression.

Remarks

Important

This API is intended to be used with the legacy SchedulerStorage only. Starting with version 18.1, SchedulerStorage and all of its satellite storages are replaced with their updated versions.

• SchedulerDataStorage replaces SchedulerStorage
• AppointmentDataStorage replaces AppointmentStorage
• ResourceDataStorage replaces ResourceStorage
• AppointmentDependencyDataStorage replaces AppointmentDependencyStorage

Resources are filtered before they are visible in the Scheduler view. If you apply a filter, the storage still contains all resources, but only resources satisfying the filter criteria are displayed in the View.

The expression syntax is described in the Criteria Language Syntax topic.

The Filter property returns the string equivalent of the CriteriaOperator specified by the AppointmentStorage.FilterCriteria property. When the Filter property is set, the AppointmentStorage.FilterCriteria obtains its value by using the CriteriaOperator.Parse method.

Tip

Use the SchedulerStorageBase.FilterAppointment and SchedulerStorageBase.FilterResource events to hide specific objects.

Example

The following code instructs the Scheduler to display appointments with the Appointment.Subject containing the word “travel” whose Appointment.Start is August, 24 2017 or later, and resources whose caption (the Resource.Caption property value) begins with the letter ‘N’.

Form1.cs

schedulerStorage1.Appointments.Filter = "Contains([Subject], 'travel') And [Start] >= #2017-08-24#";
schedulerStorage1.Resources.Filter = "StartsWith([Caption], 'N')";

Form1.vb

schedulerStorage1.Appointments.Filter = "Contains([Subject], 'travel') And [Start] >= #2017-08-24#"
schedulerStorage1.Resources.Filter = "StartsWith([Caption], 'N')"