ApplicationThemeHelper.PreloadAsync<T>() Method

Asynchronously preloads theme resources for the view specified by the UserControl.

Namespace: DevExpress.Xpf.Core

Assembly: DevExpress.Data.Desktop.v24.1.dll

NuGet Packages: DevExpress.Data.Desktop, DevExpress.ExpressApp.Win.Design

Declaration

C#

public static Task PreloadAsync<T>()
    where T : UserControl, new()

VB.NET

Public Shared Function PreloadAsync(Of T As {UserControl, New}) As Task

Type Parameters

Name	Description
T	A UserControl or its descendant.

Returns

Type	Description
Task	A task that allows you to asynchronously preload theme resources.

Remarks

Note

The PreloadAsync method allows you to preload lightweight theme resources only. Use the PreloadThemeResourceAsync method instead to asynchronously preload regular theme resources.

The following code sample asynchronously preloads resources for the MyControl:

App.xaml.cs

using DevExpress.Xpf.Core;
using System.Windows;

public partial class App : Application {
    static App() {
        CompatibilitySettings.UseLightweightThemes = true;
    }
    protected override async void OnStartup(StartupEventArgs e) {
        base.OnStartup(e);
        await ApplicationThemeHelper.PreloadAsync<MyControl>();
    }
}

App.xaml.vb

Imports DevExpress.Xpf.Core
Imports System.Windows

Public Partial Class App
    Inherits Application

    Private Shared Sub New()
        CompatibilitySettings.UseLightweightThemes = True
    End Sub

    Protected Overrides Async Sub OnStartup(ByVal e As StartupEventArgs)
        MyBase.OnStartup(e)
        Await ApplicationThemeHelper.PreloadAsync(Of MyControl)()
    End Sub
End Class

Refer to the following help topic for more information: Preload Theme Resources.