Skip to main content

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

FavoritePropertyDirectoryExtension Class

Provides the functionality to store the Property panel’s favorite properties in a file system.

Namespace: DevExpress.XtraReports.Extensions

Assembly: DevExpress.XtraReports.v24.2.dll

NuGet Package: DevExpress.Reporting.Core

#Declaration

public class FavoritePropertyDirectoryExtension :
    FavoritePropertyExtension

#Remarks

The End-User Report Designer’s Properties panel provides the Favorite view that allows end-users to display only their favorite or most frequently used properties.

The FavoritePropertyDirectoryExtension class is inherited from the abstract FavoritePropertyExtension class and is intended to manage persisting favorite properties in a file system. By default, these properties are stored in the %localappdata%\Developer Express Inc\XtraReports Suite\ComponentProperties.xml file.

To provide a custom file storage, you can create an instance of the ReportGalleryDirectoryExtension class with the required path passed as a parameter, and register this instance using the static RegisterExtensionGlobal method.

The following code snippet demonstrates how to specify the path to the directory with the application’s executable file.

using System.Windows.Forms;
using System.IO;
using DevExpress.XtraReports.Extensions;

static class Program {
    static void Main() {
        // ...
        string path = Path.Combine(Application.StartupPath, "FavoriteProperties.xml");
        FavoritePropertyExtension.RegisterExtensionGlobal(new FavoritePropertyDirectoryExtension(path));
    }
}

See the following topics for more information:

#Inheritance

Object
FavoritePropertyExtension
FavoritePropertyDirectoryExtension
See Also