ImageZoom - RenderingModes

ImageZoom supports two different rendering modes to serve the thumbnail images in gallery.

1. Default

When using the Default mode, the thumbnails are created and served using the webpage class that contains the ImageZoom. In this mode the src of thumbnails will be like this:

<img id="ImageZoom1_ImageZoomEntry15" src="/WebForm1.aspx?f=images/big_image6.jpg" ... />

Here WebForm1.aspx will be the name of page that loads the ImageZoom control. Default RenderingMode is the default mode uses in ImageZoom and is the easiest way to add ImageZoom gallery.

But we do not recommend this method since it causes additional time and resource consumption in re-executing the page class on loading each thumnail image. For better performance, use HttpHandler mode instead.

2. HttpHandler

In HttpHandler mode the developer has some extra works, but has advantage over performance. It uses HttpHandler instead of the page class and so can be reused on each requests for image url.

You can follow any of the following method to implement HttpHandler RenderingMode.

1. Add a new ashx file with name "ImageZoomHandler.ashx" to project, inherit it from "OboutInc.ImageZoom.Handlers.ImageZoomHandler"

2. If you want to use a custom handler instead of ImageZoomHandler.ashx you need to specify handler file name in HttpHandlerName property, also the handler class must be inherited from "OboutInc.ImageZoom.Handlers.ImageZoomHandler"

3. Set up the Web.config file of your ASP.NET Web Application so it can recognize the new HTTP Handler.

<add verb="*"*" path="*"ImageZoomHandler.ashx" type="*"OboutInc.ImageZoom.Handlers.ImageZoomHandler, obout_ImageZoom_NET" />