Skip to main content
.NET Framework 4.6.2+

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

CollectionSourceModeAttribute.Mode Property

Specifies the mode of operation for the Collection Source created by the List Property Editor that represents the CollectionSourceModeAttribute‘s target property in a UI.

Namespace: DevExpress.ExpressApp

Assembly: DevExpress.ExpressApp.v24.2.dll

NuGet Package: DevExpress.ExpressApp

#Declaration

public CollectionSourceMode Mode { get; }

#Property Value

Type Description
CollectionSourceMode

A CollectionSourceMode enumeration value specifying the Collection Source’s mode of operation.

Available values:

Name Description
Normal

A collection of objects of the specified type is created by the CollectionSourceBase.ObjectSpace. For instance, the XPObjectSpace creates an XPCollection. When filtering is applied, the corresponding criteria is directly applied to the underlying collection. So, in this mode, if you iterate over the collection represented by a List View, you will only see the filtered objects.

Proxy

Two collections are created for a Collection Source. The first one is an original collection created by the Object Space. The second one is a intermediate proxy collection. The proxy collection represents the original collection’s wrapper, because it implements several interfaces that are required in different built-in features. When filtering is applied to the collection that a Collection Source represents, the criteria are not directly applied to the original collection, instead they are applied to the proxy collection. So, in this mode, if you iterate over the collection represented by the CollectionSourceBase.Collection property, you will see only filtered objects. But you can iterate over the original collection to access all objects belonging to the collection.

#Remarks

The value that you pass as the mode parameter is set to the CollectionSourceBase.Mode property of the Collection Source of the List View that represents the target collection property.

See Also