AlbumOnNet WebControl Suite

AlbumOnNet Namespace

AlbumOnNet WebControl Suite.

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.

Namespace hierarchy

Classes

ClassDescription
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.

Enumerations

EnumerationDescription
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.