All docs
V18.2
20.2
The page you are viewing does not exist in version 20.2. This link will take you to the root page.
20.1
The page you are viewing does not exist in version 20.1. This link will take you to the root page.
19.2
The page you are viewing does not exist in version 19.2. This link will take you to the root page.
19.1
The page you are viewing does not exist in version 19.1. This link will take you to the root page.
18.2
18.1
17.2

Overview - BinaryImage

  • 2 minutes to read

BinaryImage is an editor capable of displaying images from a binary stream.

Implementation Details

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

The BinaryImage's client counterpart is represented by the ASPxClientBinaryImage object.

Declaration

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

Controller code:

public ActionResult ViewPage1(int? employeeID){
    return View("ViewPage1", GetEmployee(employeeID.Value));
}

public Employee GetEmployee(int employeeID){
    DataClasses1DataContext DB = new DataClasses1DataContext();
    return (from employee in DB.Employees where employee.EmployeeID == employeeID select employee).SingleOrDefault();
}

View code - "ViewPage1" (Razor):

<h2>Details:</h2>

@Html.DevExpress().BinaryImage(
    settings => {
        settings.Name = "binaryImage1";
    }).Bind((Model.Photo).ToArray()).GetHtml()

or

View code - "ViewPage1" (Razor):

<h2>Details:</h2>

@Html.DevExpress().BinaryImage(
    settings => {
        settings.Name = "binaryImage1";

        settings.ContentBytes = (Model.Photo).ToArray();
    }).GetHtml()
NOTE

To enable the file downloading and uploading functionality, the Partial View with the extension must be wrapped with the HTML form. Since this functionality is implemented through the UploadControl extension, it's also necessary to fulfill all the recommendations from the corresponding KB article.

NOTE

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

The code result is demonstrated in the image below.

binaryimage-declaration.png

See Also