Skip to main content
All docs
V25.1
  • AsyncDownloadPolicy.FailedEventArgs.Content Property

    Gets or sets the content in place of an external resource that fails to load.

    Namespace: DevExpress.Data

    Assembly: DevExpress.Data.v25.1.dll

    NuGet Package: DevExpress.Data

    Declaration

    public Stream Content { get; set; }

    Property Value

    Type Description
    Stream

    The stream with the content.

    Remarks

    Read the following topic for additional information: Suppress Control Requests to Download Data from External URLs.

    Example

    The following example handles the Failed event to display a placeholder image in a WinForms PictureEdit if an external image fails to load:

    public Form1() {
        InitializeComponent();
        DevExpress.Data.AsyncDownloadPolicy.Failed += AsyncDownloadPolicy_Failed;
    }
    
    void AsyncDownloadPolicy_Failed(object sender, DevExpress.Data.AsyncDownloadPolicy.FailedEventArgs e) {
        if (e.ValueType.Name == "ImageOrSvgImageResult") {
            MemoryStream stream = new MemoryStream();
            /* A placeholder image is obtained from the DevExpress SvgImageCollection.
             * The placeholder image was added to the SvgImageCollection at design time.
             */
            var errorImage = svgImageCollection1[0];
            errorImage.Save(stream);
            e.Content = stream;
        }
    }
    
    async void btnLoadImage_Click(object sender, EventArgs e) {
        await pictureEdit1.LoadAsync("EXTERNAL_IMAGE_URL");
    }
    
    See Also