Installation to Visual Studio Create a new Tab on the Toolbox in Visual Studio and name it AlbumOnNet. To create a new Tab, right-click in the Toolbox and select Add New Tab. Add the AlbumOnNet to the new Tab (Right-Click in the Tab and select Add/Remove Items... Browse to where you unpacked the distribution file and select the AlbumOnNet.dll file. Press OK. The AlbumOnNet Tab in the Toolbox now contains the AlbumOnNet WebControls.
Before you start using the controls in an IDE (Visual Studio, WebMatrix etc): Copy the skin files found in the samples application subfolder skins to the root of your project folder.
Note The Album (and sometimes also the SlideShow) is designed to work with physical image files stored in a folder directly available to the Web application. The Album (and sometimes the SlideShow) will initiate the creation of thumbnail image files and XML-files on the server, and thus will need full file write access to the folder where the image files are stored. When the thumbnails are generated, an XML file containing meta data for the images is also created. You will need to grant the anonymous user running the Web application full access to the image file folder(s). The name of the anonymous user on a machine is normally the ASPNET user. You grant access rights using the File Manager on the machine. Right click on the folder, select Properties-Security, Add.. the user and grant all rights. On a web server where you do not have direct access to the FileManager, most Web hosts will have a custom Control Panel where you can perform this task. If they do not provide a custom Control Panel, you will need to contact your Web hosting provider directly.
Image files will need to be copied or uploaded to the server manually (e.g. using File Copy, FTP or a custom made Upload page. The AlbumOnNet WebControls does not perform any uploading.
If you add new image files to an existing album folder, you will need to rebuild the XML file containing the meta data. This can be done by deleting the existing AlbumOnNet.xml file found in the folder or by making a custom page that calls the Build method.
The following WebControls is provided with AlbumOnNet.
Album. Can be connected to a SlideShow in the SlideShowControl property.
SlideShow. Use as a SlideShow viewer and also as a image viewer for an Album.
SlideInfoViewer. Must be connected to a SlideShow in the SlideInfoViewerControl property.
SlideInfoLabel. Must be connected to a SlideShow in the SlideShowControl property.
SlideShowImageButtonToolBar. Must be connected to a SlideShow in the SlideShowControl property.
SlideShowImageButton. A custom ImageButton for a SlideShow or a SlideShowImageButtonToolBar.
SlideShowLinkButtonToolBar. Must be connected to a SlideShow in the SlideShowControl property.
SlideShowLinkButton. A custom LinkButton for a SlideShow or a SlideShowLinkButtonToolBar.
SlideShowButtonToolBar. Must be connected to a SlideShow in the SlideShowControl property.
SlideShowButton. A custom button for a SlideShow or a SlideShowButtonToolBar.
SlideShowPageNumberLabel. SlideShow Page Number label. Must be connected to a SlideShow in the SlideShowControl property.
SlideFullSizeLink. A hyperlink that opens a Slide in a new window. Must be connected to a SlideShow in the SlideShowControl property.
Additional useful classes.
AlbumBuilder. Creates and maintain Thumbnail files and Album/SlideShow DataSource as a .Net DataSet stored in an XML file.
AlbumDataSetHelper A class that helps developers wanting to set the Album datasource manually.
| Class | Description |
|---|---|
| Album | Album WebControl. |
| AlbumBuilder | Creates and maintain Thumbnail files and Album/SlideShow DataSource as a .Net DataSet stored in an XML file. |
| AlbumDataSetHelper | A helper class for the AlbumDataSet. Retrieve a new empty DataSet here. |
| AlbumImage | Image Web Control used in the Album. |
| AlbumImageClickEventArgs | Event arguments for the Click event. |
| AlbumItemTemplate | Default internally generated ItemTemplate for an Album Item |
| AxpSlideShowToolBarBuilder | |
| AxpSlideShowToolBarLinkBuilder | |
| AxpSlideShowToolBarTxtBuilder | |
| ImagePrefetch | A helper class to set Image prefetch type. |
| ImagePrefetchConverter | |
| Slide | A single Slide for use in the SlideCollection |
| SlideCollection | A collection of Slide objects. |
| SlideFullSizeLink | WebControl that displays a hyperlink (or clickable image button) that opens a Slide Image in a separate window for full size viewing. |
| SlideInfoLabel | WebControl that displays a single column from the meta data associated with a Slide. |
| SlideInfoViewer | WebControl that displays meta data associated with a Slide in a SlideShow. |
| SlideInfoViewerConverter | |
| SlideShow | SlideShow WebControl. Use it as a standalone SlideShow, or as a combined SlideShow and image viewer for the Album control. |
| SlideShowButton | Button WebControl for use in the SlideShowButtonToolBar or on its own. |
| SlideShowButtonToolBar | A Toolbar WebControl for a SlideShow containing SlideShowButton child controls. |
| SlideShowConverter | |
| SlideShowImageButton | ImageButton WebControl for use in the SlideShowImageButtonToolBar or on its own. |
| SlideShowImageButtonToolBar | A Toolbar WebControl for a SlideShow containing SlideShowImageButton child controls. |
| SlideShowLinkButton | Link Button WebControl for use in the SlideShowLinkButtonToolBar or on its own. |
| SlideShowLinkButtonToolBar | A Toolbar WebControl for a SlideShow containing SlideShowLinkButton child controls. |
| SlideShowPageNumberLabel | A WebControl to display Page Numbers for a SlideShow. |
| StaticFilter | Internet Explorer Static Effect Filter for a SlideShow |
| StaticFilterCollection | A collection of StaticFilters. |
| TransitionFilter | Internet Explorer Transition Effect Filter for a SlideShow |
| TransitionFilterCollection | A collection of TransitionFilters. |
| Enumeration | Description |
|---|---|
| AlbumBuildType | Type of Album Thumbnail and XML file rebuild. |
| DXStaticFilters | |
| DXTransitions | |
| PrefetchTypes | How images should be prefetched by the browser when opening a SlideShow or moving from slide to slide. |
| ScalingType | Determines the scaling type to apply for each image in a SlideShow. |
| SlideOrderType | Determines the ordering of Images in a SlideShow. |
| SlideShowAction | The action to perform on a SlideShow when a button is clicked. |