AlbumOnNet WebControl Suite for ASP.NET

Album/Gallery/Filmstrip and SlideShow/AdRotator controls + Utility Controls and class library.

© Axezz, Oslo Norway 2004-2006

http://www.axezz.com/albumonnet
http://www.albumonnet.com/

Document date : 2006-11-06
Current Version : 1.4.3
.NET 1.1. Assembly Version : 1.4.3.0 (2006-11-06)
.NET 2.0. Assembly Version : 1.4.3.0 (2006-11-06)

Installation and use

Requirements


AlbumOnNet requires .Net FrameWork 1.1 SP1 or .Net 2.0

Visual Studio 2003, 2005 and WebMatrix is supported.

.Net 1.1 installation: Use the AlbumOnNet.dll file found in the folder Install\NET11

.Net 2.0 installation: Use the AlbumOnNet.dll file found in the folder Install\NET20

Follow instructions below.

Adding the WebControls to the Toolbox in Visual Studio.Net 2003/2005

  1. Open a WebForm in Design Mode in Visual Studio.Net.
  2. Right click the Visual Studio Toolbox and select Add Tab
  3. Name the new Tab "AlbumOnNet"
  4. Select the new Tab
  5. Right click inside the new Tab and select Add/Remove Items.../Choose Items...
  6. Select Browse... and locate the AlbumOnNet.dll file.
  7. Click OK. The WebControls should now be visible in the ToolBox.
  8. You can now drag and drop AlbumOnNet WebControls from the Toolbox in Visual Studio onto your page, just like any other WebControl.

Adding the WebControls to the Toolbox in Microsoft ASP.NET Web Matrix

  1. Adding the AlbumOnNet WebControls to the Toolbox in Web Matrix.
  2. Select the "Custom Controls" tab.
  3. Right-Click in the Toolbox and select "Add Local Toolbox Items..."
  4. Click "Browse..." and locate the AlbumOnNet.dll file.
  5. When WebMatrix ask if you want to add the control to the GAC, answer No.
  6. The WebControls should now be visible and available in the Toolbox.
  7. You can now drag and drop AlbumOnNet WebControls from the Toolbox in Visual Studio onto your page, just like any other WebControl.
  8. Always create a proper web application when using AlbumOnNet (E.g. using Internet Service Manager)
  9. Place the AlbumOnNet.dll in the applications bin directory. (Create the directory manually if it does not exist)

Enhancing the IDE Design mode experience (Visual Studio, WebMatrix)

  1. Completing this step will enhance the Design Mode in IDE's. Normally when viewing a SlideShow or Album inside the IDE, it will not display any images. AlbumOnNet supplies a standard preview image file that can be used for IDE design work.
  2. Unzip the AlbumOnNet.zip file to C:\AlbumOnNet on the local machine. You should then have the directory C:\AlbumOnNet\Install\skins on your machine and you can skip part 3.
  3. If you choose another installation directory than C:\AlbumOnNet, edit the content of the AlbumOnNet.reg file found in the Install subdirectory to point the location you chose. DoubleClick on the AlbumOnNet.reg file.
  4. These steps will ensure that the image files Install\skins\designslide.jpg and Install\skins\designthumb.jpg is used when working with the Album and SlideShow control in design mode in Visual Studio and Web Matrix.

Enable AlbumOnNet in your ASP.NET application

  1. Copy the AlbumOnNet.dll file to the bin directory of your application. (Visual Studio does this automatically if you drag and drop the control from the ToolBox into the design surface.)
  2. Make sure to add a reference to AlbumOnNet.dll in your project. ((Visual Studio does this automatically if you drag and drop the control from the ToolBox into the design surface.)
  3. Read at least the first page of the Help file!
  4. IMPORTANT NOTE. PLEASE DO READ. AlbumOnNet creates thumbnail files and XML files in the folders where images are stored.
    If this is supposed to work, you will need to grant file access rights to the anonymous ASP.NET user.

    Granting full file access right to the directory where your images are stored:
    Grant it to the computer's anonymous ASP.NET user (normally the user named ASPNET).
    You can do this by right clicking the folder in the File Manager, Selecting Properties->Security->Add, selecting and adding the ASPNET user and grant full rights.
  5. Study the Demo pages if needed.
  6. For licensed versions, copy the AlbumOnNet.lic file to bin directory of the application.

Get the Demo Pages up and running

  1. Copy the AlbumOnNetDemo folder to your web server, or to the root of the web on your local machine (typically c:\Inetpub\wwwroot).
  2. Create a virtual directory for AlbumOnNetDemo folder.
    This can be done using Internet Service Manager, or by right clicking the folder in the File Manager, selecting Sharing->WebSharing->Share this folder.
  3. IMPORTANT NOTE. PLEASE DO READ. AlbumOnNet creates thumbnail files and XML files in the folders where images are stored.
    If this is supposed to work, you will need to grant file access rights to the anonymous ASP.NET user.

    Granting full file access right to the album sub directory:
    Grant it to the computer's anonymous ASP.NET user (normally the user named ASPNET).
    You can do this by right clicking the folder in the File Manager, Selecting Properties->Security->Add, selecting and adding the ASPNET user and grant full rights.
  4. Point your browser to the newly created virtual directory (e.g. http://localhost/AlbumOnNetDemo)

Get the Demo Gallery Application up and running

  1. Follow the instructions found in the AlbumOnNetApps/readme.txt file.

Version History

Gallery application fix

2006-05-18
  • Fix. The Admin page in the Gallery application had commands in the Update, Edit and Delete commands of the grid that used the builder.XMLFileName property. It should be XMLFilePath property in the latest releases.

Version 1.4

Assembly Version : (NET 2.0) 1.4.3.0 (2006-11-06)
Assembly Version : (NET 1.1) 1.4.3.0 (2006-11-06)
  • The SlideInfoLabel can now be used when the SlideShow.Slides collection is set manually, i.e. when a SlideShow.AlbumUrl is not set and SlideShow is not connected to an Album control.
Assembly Version : (NET 2.0) 1.4.2.0 (2006-01-31)
Assembly Version : (NET 1.1) 1.4.2.0 (2006-01-31)
  • Fix. SlideShow.ActiveSlide can now be set in the SlideShow.Load event. Previously when setting SlideShow.ActiveSlide, it did not have any effect unless it was set as late as in the Page or SlideShow PreRender event.
  • Fix. EXIF strings containing NewLine or CarriageReturn characters would break the client side javascript functionality.
Assembly Version : (NET 2.0) 1.4.1.0 (2006-01-03)
Assembly Version : (NET 1.1) 1.4.1.0 (2006-01-03)
  • The new properties Album.Builder and SlideShow.Builder give access to the automatically created AlbumBuilder and the new property AlbumBuilder.XMLFileName (Get/Set)

    If set, the Album or SlideShow will use the given xml file name instead of the default "AlbumOnNet.xml". It is then possible to programmatically or manually alter the content of an Album xml file and use that as basis for an Album or SlideShow. The new property AlbumBuilder.XMLFilePath (Get)
    returns the full file path to the current xml file.

    Examples:
    Album1.Builder.XMLFileName = "Test.xml";
    or
    SlideShow1.Builder.XMLFileName = "Test.xml";
  • Fix. If SlideShow.SlideOrder was Random, the first image would only be displayed for a very short time before advancing to the next in the list.
  • Fix. Design time issue.

    Slideshow scaling in the IDE was based on the sample image size (461x307), even when the Slide collection was filled. It will now use the ImageWidth and ImageHeight property (if it is set) of the first slide in the collection. If the ImageWidth or ImageHeight is not used the respective sample image dimension is used instead. Note that this only applies for SlideShows where the Slide collection is set using the <Slides> collection, and not for SlideShows where the content is set using the AlbumUrl property.

Version 1.3

Assembly Version : 1.3.2.0 (2005-06-13)
  • Fix. Escaped quotes in Exif meta data values in client side script.
Assembly Version : 1.3.1.0 (2005-05-02)
  • Fix. SlideShowLinkButtonToolBar / SlideShowImageButtonToolBar sometimes erronously persisted child controls tags when used in the Designer.
Assembly Version : 1.3.0.0 (2005-02-22)
  • It is no longer needed to create a registry setting to enable the default design time picture path if the design time picture folder is C:\AlbumOnNet\Install\skins. Othwerwise the registry setting is still needed.
  • The SlideShow and Album will now detect if the AlbumUrl has changed between Page postbacks and automatically reload the new AlbumUrl. The ActiveSlide property must still be reset manually to 0 in this case.
  • New method Album.RefreshAlbum. Used when an Album.AlbumUrl is changed between postbacks and the Album has a connected SlideShow.

Version 1.2

Assembly Version : 1.2.0.0 (2004-12-29)
  • Fix. Attaching SlideInfoLabels or a SlideInfoViewer to a Server Side Paged SlideShow caused an internal cast error.

Version 1.1

Assembly Version : 1.1.1778.42030 (2004-11-13)
  • New WebControl SlideFullSizeLink. Hyperlink (or ImageLink) that will display a Slide Image full size in a new window.
  • New property Album.ImageStyle. You can now set a Style for the images in the Album. In version 1.0 you could only set the ItemStyle which is style for the rectangle enclosing each Image and the Title below it.
  • The Gallery Application source code is now available in VB and C#.

Version 1.0

Assembly Version : 1.0.1771.35141 (2004-11-06)
  • Enhancements made to the AlbumBuilder class to give greater flexibility when generating XML DataSource files and Thumbnails.
  • Made a Gallery/SlideShow application with Admin features. C# code.
  • Small enhancements and fixes made to the DHTML javascripts.

Version 1.0 RC1

Assembly Version: 1.0.1766.32524 (2004-11-01)
  • Initial public release.