[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]ASP.NET WebForms Controls
 [Collapse]ASP.NET MVC Extensions
  [Expand]Product Information
  [Expand]Getting Started
  [Expand]Common Concepts
  [Expand]Grid View
  [Expand]Tree List
  [Expand]Card View
   Reporting
  [Expand]Charting
  [Expand]Pivot Grid
   Spreadsheet
   Rich Text Editor
  [Expand]Scheduler
  [Expand]Site Navigation and Layout
  [Expand]HTML Editor
  [Expand]Vertical Grid
  [Collapse]Data Editors
    Editor List
    Main Features
   [Expand]Common Concepts
    BinaryImage
   [Expand]Button
    ButtonEdit
    Calendar
   [Expand]Captcha
    CheckBox
    CheckBoxList
   [Expand]ColorEdit
   [Expand]ComboBox
   [Expand]DateEdit
    DropDownEdit
    Filter Control
    GridLookup
    HyperLink
    Image
    Label
    ListBox
    Memo
   [Expand]ProgressBar
    RadioButton
    RadioButtonList
    SpinEdit
    TextBox
    TimeEdit
    TokenBox
   [Expand]TrackBar
    Validation Summary
   [Expand]Strongly-Typed Editor Types
  [Expand]Docking and Popups
  [Expand]File Management
  [Expand]Data and Image Navigation
  [Expand]Multi-Use Site Extensions
  [Expand]Spell Checker
  [Expand]Query Builder
 [Expand]Localization
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Image

Image is an editor for displaying images.

Expanded Implementation Details

Image is realized by the ImageEditExtension class. Its instance can be accessed via the ExtensionsFactory.Image helper method, which is used to add an Image extension to a view. This method's parameter provides access to the Image's settings implemented by the ImageEditSettings class, allowing you to fully customize the extension.

The Image's client counterpart is represented by the ASPxClientImage object.

Expanded Declaration

Image can be added to a view in the following manner.

View code (ASPX):

View code (Razor):

Note

The Partial View should contain only the extension's code.

The code result is demonstrated in the image below.

Expanded Main Features

The Image editor can be used to display any valid image supported by the requesting browser on the web page.

The path to the displayed image is specified by the ImageEditSettings.ImageUrl property. You can specify the text you wish to display in place of an image when the image is not available by setting the ImageEditSettings.Properties.AlternateText (ImageEditPropertiesBase.AlternateText) property. The ImageEditSettings.Properties.EmptyImage (ImageEditPropertiesBase.EmptyImage) property allows you to define a specific image to be displayed by the image editor if the editor's value is null (or the ImageEditSettings.ImageUrl property is not defined or is set to an empty string). The alignment of the displayed image in relation to other elements on the web page is specified by the ImageEditSettings.Properties.ImageAlign (ImageEditPropertiesBase.ImageAlign) property.

Is this topic helpful?​​​​​​​