Skip to main content
.NET Framework 4.6.2+

XpoDataView Members

A lightweight read-only list of data records (a data view) retrieved from a database without loading complete XPO objects. Can be queried much more quickly than a real objects collection.

Constructors

Name Description
XpoDataView(XPObjectSpace, Type, IList<DataViewExpression>, CriteriaOperator, IList<SortProperty>) Initializes a new instance of the XpoDataView class with the specified settings. Data view columns are specified using the list of DataViewExpression objects. For internal use only.
XpoDataView(XPObjectSpace, Type, String, CriteriaOperator, IList<SortProperty>) Initializes a new instance of the XpoDataView class with the specified settings. Data view columns are specified using the semicolon-separated list of expression strings. For internal use only.

Fields

Name Description
UseServerSideSorting Indicates that the sort operation is executed on the server side before the result set is trimmed according to the TopReturnedObjects property.

Properties

Name Description
AllowEdit Gets whether you can update data records. This method always returns false because the list represented by XafDataView is readonly. Inherited from XafDataView.
AllowNew Gets whether you can add data records. This method always returns false because the list represented by XafDataView is readonly. Inherited from XafDataView.
AllowRemove Gets whether you can update data records. This method always returns false because the list represented by XafDataView is readonly. Inherited from XafDataView.
Count Gets the number of data records contained in the XafDataView. Inherited from XafDataView.
Criteria Specifies criteria used to filter the data view at the server side. Inherited from XafDataView.
DefaultUseServerSideSorting static Indicates that the sort operation is executed on the server side before the result set is trimmed according to the TopReturnedObjects property. This field affects all List Views in your application if you do not specify the UseServerSideSorting property for a particular List View.
Expressions Specifies data view column names and expressions used to compute column values. Inherited from XafDataView.
Filter
IsFixedSize Gets a value indicating whether the data view has a fixed size. This property value is always false because the list represented by XafDataView is readonly. Inherited from XafDataView.
IsLoaded Gets a value that indicates whether or not the data records list cached by XafDataView is initialized. Inherited from XafDataView.
IsReadOnly Gets a value indicating whether the list repersented by XafDataView is read-only. Always returns true. Inherited from XafDataView.
IsSynchronized Gets a value indicating whether access to the data view is synchronized. This method always returns false Inherited from XafDataView.
Item[Int32] Gets the data record at the specified index. Inherited from XafDataView.
ObjectSpace Gets the Object Space used to query data by the current XafDataView. Inherited from XafDataView.
ObjectType Gets the type of business objects that are queried by XafDataView. Inherited from XafDataView.
Sorting Specifies the sorted columns within the data view. Inherited from XafDataView.
SyncRoot Gets an object that can be used to synchronize access to the data view. Always returns the XafDataView instance itself, because the data view’s underlying store is not is not publicly available (see the Remarks section of the ICollection.SyncRoot Property topic). Inherited from XafDataView.
TopReturnedObjectsCount Specifies the number of data records retrieved by the XafDataView. Inherited from XafDataView.

Methods

Name Description
Add(Object) This method is required to provide IList support. It always throws a NotSupportedException because the list represented by XafDataView is readonly (see the Exceptions section of the IList.Add Method topic). Inherited from XafDataView.
Clear() This method is required to provide the IList support. It always throws a NotSupportedException because the list represented by XafDataView is readonly (see the Exceptions section of the IList.Clear Method topic). Inherited from XafDataView.
Contains(Object) Determines whether the XafDataView contains a specific data record. Inherited from XafDataView.
CopyTo(Array, Int32) Copies the data records to an array, starting at a particular array index. Inherited from XafDataView.
Dispose() Releases all resources used by this XpoDataView object.
Equals(Object, Object) static Determines whether the specified object instances are considered equal. Inherited from Object.
Equals(Object) Determines whether the specified object is equal to the current object. Inherited from Object.
FindExpression(String) Finds the expression by its name in the current XafDataView. Inherited from XafDataView.
GetHashCode() Serves as the default hash function. Inherited from Object.
GetType() Gets the Type of the current instance. Inherited from Object.
IndexOf(Object) Determines the index of a specific data record in the XafDataView. Inherited from XafDataView.
Insert(Int32, Object) This method is required to provide IList support. It always throws a NotSupportedException because the list represented by XafDataView is readonly (see the Exceptions section of the IList.Insert Method topic). Inherited from XafDataView.
MemberwiseClone() protected Creates a shallow copy of the current Object. Inherited from Object.
ReferenceEquals(Object, Object) static Determines whether the specified Object instances are the same instance. Inherited from Object.
Reload() Clears the data records cache. Inherited from XafDataView.
Remove(Object) This method is required to provide IList support. It always throws a NotSupportedException because the list represented by XafDataView is readonly (see the Exceptions section of the IList.Remove Method topic). Inherited from XafDataView.
RemoveAt(Int32) This method is required to provide IList support. It always throws a NotSupportedException because the list represented by XafDataView is readonly (see the Exceptions section of the IList.RemoveAt Method topic). Inherited from XafDataView.
ToString() Returns a string that represents the current object. Inherited from Object.

Events

Name Description
ListChanged Occurs when the data records list is changed. Inherited from XafDataView.
See Also