The requested page is not available for the requested platform. You are viewing the content for Default platform.

MediaDataObject Class

The entity used to store media data in the database.

Namespace: DevExpress.Persistent.BaseImpl.EF

Assembly: DevExpress.Persistent.BaseImpl.EF.v19.1.dll

Declaration

[MediaDataObject("MediaDataKey", "MediaData", "MediaResource.MediaData")]
[Browsable(false)]
[EditorAlias("ImagePropertyEditor")]
public class MediaDataObject :
    IXafEntityObject,
    INotifyPropertyChanged
<MediaDataObject("MediaDataKey", "MediaData", "MediaResource.MediaData")>
<Browsable(False)>
<EditorAlias("ImagePropertyEditor")>
Public Class MediaDataObject
    Implements IXafEntityObject,
               INotifyPropertyChanged

Remarks

You can use the MediaDataObject type to declare a reference property of a business class that will be used to store and display an image.

Both WinForms and ASP.NET Image Property Editors are used automatically for properties of the MediaDataObject type.

An example is provided in the Image as a MediaDataObject section of the BLOB Image Properties in Entity Framework topic.

MediaDataObject is a container for three values:

Value

Description

MediaDataObject.MediaData

A byte array object that is loaded from a database on demand when required. It is not loaded together with the MediaDataObject itself and may contain any type of media. This property is non-persistent, its value is stored using the MediaResource.MediaData persistent property to provide delayed loading.

MediaDataObject.MediaDataKey

A key value of the string type. This value should not be changed from your code. It is updated automatically when the MediaData byte array is changed and is unique for each MediaDataObject. MediaDataKey is used in a URL of the MediaData loaded by a browser. The URL is generated under the following conditions.

  • MediaDataKey is constant while MediaData is not updated.
  • It is not required to load MediaData when generating the URL.
  • MediaDataKey can be quickly obtained as it is not required to load MediaData every time to calculate the key.

MediaDataObject.MediaResource

The MediaResourceObject object which exposes the MediaData property of the byte array type. The MediaData property of this object is persistent and stores the byte array returned by the MediaDataObject.MediaData property.

Currently, the MediaDataObject property type is completely supported by the ASPxImagePropertyEditor only. The ImagePropertyEditor supports it partially - it uses MediaData only, and does not provide caching.

Note

It is not recommend to change the MediaData value by direct database queries. In this instance, the URL will not change, and it will be required to manually refresh the page to see the changes.

Inheritance

Object
MediaDataObject

Implements

See Also