Using FileUltimate in an ASP.NET WebForms project

To use FileUltimate in an ASP.NET WebForms Project, do the following in Visual Studio:

Make sure you have added references to FileUltimate assemblies as described here.

Optionally set FileUltimate's global configuration (if overriding a default value is required). For example, you may want to set the license key.

You can specify the configuration in <appSettings> tag of your Web.config.

XML

<appSettings> <!-- Set this property only if you have a valid license key, otherwise do not set it so FileUltimate runs in trial mode. --> <add key="FileUltimate:LicenseKey" value="QQJDJLJP34..." /> </appSettings>

As you would notice, FileUltimate: prefix maps to FileUltimateConfiguration.Current and FileUltimateWeb: prefix maps to FileUltimateWebConfiguration.Current.

Alternatively you can specify the configuration in code, in Application_Start method of your Global.asax.cs:

protected void Application_Start(object sender, EventArgs e) { //Set this property only if you have a valid license key, otherwise do not //set it so FileUltimate runs in trial mode. FileUltimateConfiguration.Current.LicenseKey = "QQJDJLJP34..."; }

Sub Application_Start(ByVal sender As Object, ByVal e As EventArgs) 'Set this property only if you have a valid license key, otherwise do not 'set it so FileUltimate runs in trial mode. FileUltimateConfiguration.Current.LicenseKey = "QQJDJLJP34..." End Sub

Create a new page (eg. Default.aspx) and insert these lines (after Page directive at the top):

ASPX

<%@ Register TagPrefix="GleamTech" Namespace="GleamTech.FileUltimate.AspNet.UI" Assembly="GleamTech.FileUltimate" %> <%@ Register TagPrefix="GleamTech" Namespace="GleamTech.FileUltimate.AspNet.WebForms" Assembly="GleamTech.FileUltimate" %> <!DOCTYPE html> <html> <head runat="server"> <title>File Manager</title> </head> <body> <GleamTech:FileManagerControl ID="fileManager" runat="server" Width="800" Height="600" Resizable="True"> <GleamTech:FileManagerRootFolder Name="A Root Folder" Location="~/App_Data/RootFolder1" > <GleamTech:FileManagerAccessControl Path="\" AllowedPermissions="Full"/> </GleamTech:FileManagerRootFolder> </GleamTech:FileManagerControl> </body> </html>

This will render a file manager control in the page which displays one root folder named "A Root Folder" which points to "~/App_Data/RootFolder1" with Full permissions.

Tip

Alternatively you can add the namespaces globally in Web.config under <system.web>/<pages>/<controls> tag to avoid adding namespaces in your pages every time:

XML

<system.web> <pages> <controls> <add tagPrefix="GleamTech" namespace="GleamTech.FileUltimate.AspNet.UI" assembly="GleamTech.FileUltimate" /> <add tagPrefix="GleamTech" namespace="GleamTech.FileUltimate.AspNet.WebForms" assembly="GleamTech.FileUltimate" /> </controls> </pages> </system.web>

If you need a standalone file uploader control, insert these lines instead:

ASPX

<%@ Register TagPrefix="GleamTech" Namespace="GleamTech.FileUltimate.AspNet.UI" Assembly="GleamTech.FileUltimate" %> <%@ Register TagPrefix="GleamTech" Namespace="GleamTech.FileUltimate.AspNet.WebForms" Assembly="GleamTech.FileUltimate" %> <!DOCTYPE html> <html> <head runat="server"> <title>File Uploader</title> </head> <body> <GleamTech:FileUploaderControl ID="fileUploader" runat="server" Width="600" Height="300" Resizable="True" UploadLocation = "~/App_Data/Uploads" /> </body> </html>