PictureEdit.LoadAsync(String) Method

Loads the specified image, asynchronously.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v19.2.dll

Declaration

C#

public void LoadAsync(
    string url
)

VB.NET

Public Sub LoadAsync(
    url As String
)

Parameters

Name	Type	Description
url	String	The path for the image to display in the PictureEdit.

Remarks

Use this method to load large images or images on a network with slow connections. The method loads the specified image in a different thread, so it doesn’t affect the performance of the main thread. To get whether the load is in progress, see the PictureEdit.LoadInProgess property. After the image has been loaded, the PictureEdit.LoadCompleted/RepositoryItemPictureEdit.LoadCompleted event fires.

You can provide the following helper images for the PictureEdit control:

• RepositoryItemPictureEdit.InitialImage - The image displayed before the target image has been loaded.
• RepositoryItemPictureEdit.ErrorImage - The image displayed if an error occurs during the target image load.

To cancel the asynchronous image load, call the PictureEdit.CancelLoadAsync method.