XPBaseCollection.Reload() Method

Clears the collection and marks it to be reloaded with data from the data store.

Namespace: DevExpress.Xpo

Assembly: DevExpress.Xpo.v19.1.dll

Declaration

C#

public virtual void Reload()

VB.NET

Public Overridable Sub Reload

Remarks

An XPCollection is not loaded with data immediately after it has been created. Data is loaded on-demand, i.e. when the collection’s contents is accessed. The Reload method clears the collection, but doesn’t force it to reload immediately. The collection will be populated with data only when its contents are accessed.

The Reload method does not reload objects that are already loaded from a database (even if they are modified), unless they are modified by another application.

Note

When an XPCollection is created using a constructor with the criteriaEvaluationBehavior parameter, it is loaded immediately and its XPBaseCollection.LoadingEnabled property is automatically set to false. After that, the collection cannot be reloaded using the Reload method, since object loading is disabled. Calling this method only clears the collection.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Reload() 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#

Reporting_embedded-end-user-report-designer-demonstration-e20017/CS/Contacts/Controls/PersonListControl.cs#L47

{
    collectionPersons.Reload();
}

XPO_how-to-view-persistent-objects-in-the-xtragrid-and-edit-them-in-a-separate-window-e771/CS/FormEditOrder.cs#L61

if(sourceOrder == null)
    sourceCollection.Reload();
else

how-to-display-a-linked-object-one-to-one-relation-as-a-detail-card-view-in-the-xtragrid-e734/CS/Form1.cs#L216

    colContacts.Reload();
}

reporting-winforms-custom-report-storage/CS/XpoReportStorage.cs#L58

    Session.CommitChanges();
    items.Reload();
}

VB.NET

Reporting_embedded-end-user-report-designer-demonstration-e20017/VB/Contacts/Controls/PersonListControl.vb#L56

Public Sub Reload() Implements IControl.Reload
    collectionPersons.Reload()
End Sub

XPO_how-to-view-persistent-objects-in-the-xtragrid-and-edit-them-in-a-separate-window-e771/VB/FormEditOrder.vb#L41

If sourceOrder Is Nothing Then
    sourceCollection.Reload()
Else

how-to-display-a-linked-object-one-to-one-relation-as-a-detail-card-view-in-the-xtragrid-e734/VB/Form1.vb#L198

    colContacts.Reload()
End If

reporting-winforms-custom-report-storage/VB/XpoReportStorage.vb#L65

    Session.CommitChanges()
    items_Renamed.Reload()
End Sub