---
title: "BitmapViewer..::.ImageLoadMode Property "
canonical: https://www.graphicsmill.com/docs/gm5/P_Aurigma_GraphicsMill_AjaxControls_BitmapViewer_ImageLoadMode.htm
product: "Graphics Mill 5.5 for .NET"
---

This documentation is for the old version. [Go to the latest Graphics Mill docs](https://www.graphicsmill.com/docs/gm/)

# BitmapViewer.ImageLoadMode Property 
 
Gets/sets a value that specifies how the image is loaded to a browser.
 
**Namespace:** [Aurigma.GraphicsMill.AjaxControls](https://www.graphicsmill.com/docs/gm5/N_Aurigma_GraphicsMill_AjaxControls.htm.md)
 **Assembly:** Aurigma.GraphicsMill.AjaxControls (in Aurigma.GraphicsMill.AjaxControls.dll)
 
## Syntax
  
```
<BrowsableAttribute(True)> _
Public Property ImageLoadMode As ImageLoadMode
```
 
```csharp
[BrowsableAttribute(true)]
public ImageLoadMode ImageLoadMode { get; set; }
```
 
### Property Value
The [ImageLoadMode](https://www.graphicsmill.com/docs/gm5/T_Aurigma_GraphicsMill_AjaxControls_ImageLoadMode.htm.md) enumeration member that specifies how the image is loaded to a browser.
 
## Remarks
  
The following load modes are available:
 
- **[Entire](https://www.graphicsmill.com/docs/gm5/T_Aurigma_GraphicsMill_AjaxControls_ImageLoadMode.htm.md)** Whole original image is loaded including all invisible parts. Note if the [PreviewImageEnabled](https://www.graphicsmill.com/docs/gm5/P_Aurigma_GraphicsMill_AjaxControls_BitmapViewer_PreviewImageEnabled.htm.md) property is **true**, the image is loaded in the similar manner as a progressive JPEG loading.
- **[AdaptiveTile](https://www.graphicsmill.com/docs/gm5/T_Aurigma_GraphicsMill_AjaxControls_ImageLoadMode.htm.md)** First of all, the control loads image fragment actually visible in the client area. Then, if an user scrolls the image it loads necessary parts of an original image which are visible but not loaded yet.
- **[RegularTile](https://www.graphicsmill.com/docs/gm5/T_Aurigma_GraphicsMill_AjaxControls_ImageLoadMode.htm.md)** In this mode the original image is divided into square tiles. The tile size equals to [TileSize](https://www.graphicsmill.com/docs/gm5/P_Aurigma_GraphicsMill_AjaxControls_BitmapViewer_TileSize.htm.md) property value. The control loads square fragments of the original image for corresponding tiles which are visible but not loaded yet.

If you are not going to change or modify the displayed image frequently you should use the [Entire](https://www.graphicsmill.com/docs/gm5/T_Aurigma_GraphicsMill_AjaxControls_ImageLoadMode.htm.md) mode. In this case you increase an image load time and get a completely loaded image which can be scrolled without additional delays. If [AdaptiveTile](https://www.graphicsmill.com/docs/gm5/T_Aurigma_GraphicsMill_AjaxControls_ImageLoadMode.htm.md) or [RegularTile](https://www.graphicsmill.com/docs/gm5/T_Aurigma_GraphicsMill_AjaxControls_ImageLoadMode.htm.md) mode is used you will get the image inside the control significantly faster than in the [Entire](https://www.graphicsmill.com/docs/gm5/T_Aurigma_GraphicsMill_AjaxControls_ImageLoadMode.htm.md) mode. But when you scroll the image you will need to wait untill the necessary fragment is loaded. [AdaptiveTile](https://www.graphicsmill.com/docs/gm5/T_Aurigma_GraphicsMill_AjaxControls_ImageLoadMode.htm.md) mode allows to optimize a traffic by loading only actually visible parts of the displayed image. But it requires more server resources comparing to [RegularTile](https://www.graphicsmill.com/docs/gm5/T_Aurigma_GraphicsMill_AjaxControls_ImageLoadMode.htm.md) mode.
   
## See Also

### Reference

- [BitmapViewer Class](https://www.graphicsmill.com/docs/gm5/T_Aurigma_GraphicsMill_AjaxControls_BitmapViewer.htm.md)
- [Aurigma.GraphicsMill.AjaxControls Namespace](https://www.graphicsmill.com/docs/gm5/N_Aurigma_GraphicsMill_AjaxControls.htm.md)
- [BitmapViewer.TileSize](https://www.graphicsmill.com/docs/gm5/P_Aurigma_GraphicsMill_AjaxControls_BitmapViewer_TileSize.htm.md)

### Manual

- [Displaying Image in BitmapViewer (AJAX Controls)](https://www.graphicsmill.com/docs/gm5/AjaxControlsDisplayingImageinBitmapViewer.htm.md)