Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Collapse]eXpressApp Framework
 [Expand]Fundamentals
 [Expand]Getting Started
 [Collapse]Concepts
  [Expand]Application Solution Components
  [Collapse]Business Model Design
    Business Model Design Basics
    Built-in Business Classes for Most Popular Scenarios
   [Expand]Business Model Design with Entity Framework
   [Expand]Business Model Design with XPO
    Non-Persistent Objects
    PropertyChanged Event in Business Classes
   [Collapse]Data Types Supported by built-in Editors
     Key Properties
    [Expand]String Properties
    [Expand]Numeric Properties
    [Expand]Date and Time Properties
    [Expand]Boolean Properties
    [Collapse]BLOB Image Properties
      BLOB Image Properties in XPO
      BLOB Image Properties in Entity Framework
      BLOB Image Properties in Domain Components
    [Expand]Collection Properties
    [Expand]Reference (Foreign Key, Complex Type) Properties
    [Expand]File Attachment Properties
    [Expand]Type Properties
    [Expand]Enumeration Properties
    [Expand]Criteria Properties
    [Expand]Color Properties
     Geolocation Properties
     Miscellaneous Property Types
    Mapping Complex Types to the Database
   [Expand]Types Info Subsystem
    Connect an XAF Application to a Database Provider
    Data Annotations in Data Model
    Create and Update the Application's Database
  [Expand]Application Model
  [Expand]UI Construction
  [Expand]Extend Functionality
  [Expand]Data Manipulation and Business Logic
  [Expand]Security System
  [Expand]Localization
  [Expand]System Module
  [Expand]Extra Modules
  [Expand]Debugging and Error Handling
  [Expand]Filtering
  [Expand]Application Life Cycle
 [Expand]Design-Time Features
 [Expand]Functional Testing
 [Expand]Deployment
 [Expand]Task-Based Help
 [Expand]Frequently Asked Questions
 [Expand]API Reference
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
[Expand]End-User Documentation

BLOB Image Properties

In XAF, BLOB image properties are persisted as byte arrays and can be displayed from the following controls.

  • A PictureEdit control (default)
  • A drop-down control
Note

Here, the BLOB abbreviation stands for Binary Large OBject - a set of binary data persisted as a single entity in the database.

The ImageEditorAttribute specifies settings to be used by Image Property Editors when displaying images.

Windows Forms

ASP.NET

Note

To see Image Property Editors in action, refer to the Property Editors | Image Properties section in the Feature Center demo installed with XAF. By default, the Feature Center demo is installed in %PUBLIC%\Documents\DevExpress Demos 17.1\Components\eXpressApp Framework\FeatureCenter. The ASP.NET version of this demo is available online at http://demos.devexpress.com/XAF/FeatureCenter/. You can also watch the Image Property Editor tutorial video at the DevExpress YouTube channel.

Expanded Examples

Expanded Windows Forms Property Editors for Image Properties

Each WinForms Property Editor has a control that displays a corresponding property in a Detail View, and a repository item that displays a property in a List Editor that supports in-place editing. The table below shows both the control and repository item.

Property Editor Type and Description Control Repository Item

ImagePropertyEditor

Used by default for byte array properties decorated by the ImageEditorAttribute, and for reference properties of the MediaDataObject and MediaDataObject types .
The PictureEdit and RepositoryItemImageEdit are used by default.
Both PictureEdit and ImageEdit editors allow end-users to perform Load, Save, Delete, Cut, Copy and Paste operations using a context menu.
To configure the ImagePropertyEditor for a particular business class property, use ImageEditorAttribute.
The PictureEdit or ImageEdit editor from the XtraEditors Library RepositoryItemPictureEdit or RepositoryItemImageEdit repository item from the XtraEditors Library

Expanded ASP.NET Property Editors for Image Properties

Each ASP.NET Property Editor has controls that display a property in a Detail View's View mode and in an Edit mode (see DetailView.ViewEditMode). These controls are listed in the table below.

Property Editor Type and Description

Control Used in View Mode

Control Used in Edit Mode

ASPxImagePropertyEditor

Used by default for byte array properties decorated by the ImageEditorAttribute, and for reference properties for reference properties of the MediaDataObject and MediaDataObject types.
When displayed in view mode, the ImageEdit control is always read-only.
When the Property Editor is read-only, only the ASPxImage control is displayed. When it is editable, a table with the Edit and Clear ASPxButton type buttons is displayed as well. When an image is not yet assigned, a browse editor is displayed.

To configure the ASPxImagePropertyEditor for a particular business class property, use the ImageEditorAttribute.

In the current implementation of the ASPxImagePropertyEditor, the upload progress will not be shown in case the ImmediatePostDataAttribute is applied to the current FileData property or the IModelCommonMemberViewItem.ImmediatePostData option is enabled in the Model Editor for the current View Item.

ImageEdit representing a descendant of the Panel control from the standard library
ImageEdit representing a descendant of the Panel control from the standard library

Expanded See Also

How would you rate this topic?​​​​​​​