CollectionSourceBase.BeginUpdateCriteria() Method

Begins update of the Collection Source’s collection criteria. The criteria will not be applied to the collection until the update is complete.

Namespace: DevExpress.ExpressApp

Assembly: DevExpress.ExpressApp.v23.2.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

public void BeginUpdateCriteria()

VB.NET

Public Sub BeginUpdateCriteria

Remarks

Generally, the BeginUpdateCriteria/EndUpdateCriteria() methods should be used when you need to perform several modifications of the Collection Source’s collection CollectionSourceBase.Criteria. After you call the BeginUpdateCriteria method, you can change the criteria as required. The criteria will not be applied to the Collection Source’s collection until you call the EndUpdateCriteria() method. The following code snippet illustrates this:

C#

//...
collectionSource.BeginUpdateCriteria();
collectionSource.Criteria["1"] = CriteriaOperator.Parse("...");
collectionSource.Criteria["2"] = CriteriaOperator.Parse("...");
collectionSource.EndUpdateCriteria();
//...

VB.NET

'...
collectionSource.BeginUpdateCriteria()
collectionSource.Criteria("1") = CriteriaOperator.Parse("...")
collectionSource.Criteria("2") = CriteriaOperator.Parse("...")
collectionSource.EndUpdateCriteria()
'...

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the BeginUpdateCriteria() method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

XAF_how-to-use-criteria-property-editors-e932/CS/HowToUseCriteriaPropertyEditors.Module/CriteriaController.cs#L35

object sender, SingleChoiceActionExecuteEventArgs e) {
((ListView)View).CollectionSource.BeginUpdateCriteria();
((ListView)View).CollectionSource.Criteria.Clear();

VB.NET

XAF_how-to-use-criteria-property-editors-e932/VB/HowToUseCriteriaPropertyEditors.Module/CriteriaController.vb#L36

Private Sub FilteringCriterionAction_Execute(ByVal sender As Object, ByVal e As SingleChoiceActionExecuteEventArgs)
    CType(View, ListView).CollectionSource.BeginUpdateCriteria()
    CType(View, ListView).CollectionSource.Criteria.Clear()