Using FileUltimate in an ASP.NET MVC project

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

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

Set FileUltimate's global configuration. For example, you may want to set the license key. Insert some of the following lines (if overriding a default value is required) into the Application_Start method of your Global.asax.cs:

Copy

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

Tip
Alternatively you can specify the configuration in <appSettings> tag of your Web.config. XML Copy <appSettings> <add key="FileUltimate:LicenseKey" value="QQJDJLJP34..." /> </appSettings> As you would notice, FileUltimate: prefix maps to FileUltimateConfiguration.Current and FileUltimateWeb: prefix maps to FileUltimateWebConfiguration.Current.

Tip

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

XML

Copy

<appSettings>
  <add key="FileUltimate:LicenseKey" value="QQJDJLJP34..." />
</appSettings>

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

Create a new View (eg. Index.cshtml) and insert these lines:

Copy

@using GleamTech.AspNet.Mvc
@using GleamTech.FileUltimate.AspNet.UI

<!DOCTYPE html>
@{
    var fileManager = new FileManager
    {
        Width = 800,
        Height = 600,
        Resizable = true
    };

    var rootFolder = new FileManagerRootFolder
    {
        Name = "A Root Folder",
        Location = "~/App_Data/RootFolder1"
    };

    rootFolder.AccessControls.Add(new FileManagerAccessControl
    {
        Path = @"\",
        AllowedPermissions = FileManagerPermissions.Full
    });

    fileManager.RootFolders.Add(rootFolder);
}
<html>
    <head>
        <title>File Manager</title>
        @this.RenderHead(fileManager)
    </head>
    <body>
        @this.RenderBody(fileManager)
    </body>
</html>

@Imports GleamTech.AspNet.Mvc
@Imports GleamTech.FileUltimate.AspNet.UI

<!DOCTYPE html>
@Code
    Dim fileManager = New FileManager() With {
        .Width = 800,
        .Height = 600,
        .Resizable = True
    }

    Dim rootFolder = New FileManagerRootFolder() With {
        .Name = "A Root Folder",
        .Location = "~/App_Data/RootFolder1"
    }

    rootFolder.AccessControls.Add(New FileManagerAccessControl() With {
        .Path = "\",
        .AllowedPermissions = FileManagerPermissions.Full
    })

    fileManager.RootFolders.Add(rootFolder)
End Code
<html>
    <head>
        <title>File Manager</title>
        @Me.RenderHead(fileManager)
    </head>
    <body>
        @Me.RenderBody(fileManager)
    </body>
</html>

This will render a file manager component 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 Views/Web.config under <system.web.webPages.razor>/<pages>/<namespaces> tag to avoid adding namespaces in your pages every time: XML Copy <system.web.webPages.razor> <pages pageBaseType="System.Web.Mvc.WebViewPage"> <namespaces> <add namespace="GleamTech.AspNet.Mvc" /> <add namespace="GleamTech.FileUltimate.AspNet.UI" /> </namespaces> </pages> </system.web.webPages.razor>

Tip

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

XML

Copy

<system.web.webPages.razor>
  <pages pageBaseType="System.Web.Mvc.WebViewPage">
    <namespaces>
      <add namespace="GleamTech.AspNet.Mvc" />
      <add namespace="GleamTech.FileUltimate.AspNet.UI" />
    </namespaces>
  </pages>
</system.web.webPages.razor>

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

Copy

@using GleamTech.AspNet.Mvc
@using GleamTech.FileUltimate.AspNet.UI

<!DOCTYPE html>
@{
    var fileUploader = new FileUploader
    {
        Width = 600,
        Height = 300,
        Resizable = true,
        UploadLocation = "~/App_Data/Uploads"
    };
}
<html>
<head>
    <title>File Uploader</title>
    @this.RenderHead(fileUploader)
</head>
<body>
    @this.RenderBody(fileUploader)
</body>
</html>

@Imports GleamTech.AspNet.Mvc
@Imports GleamTech.FileUltimate.AspNet.UI

<!DOCTYPE html>
@Code
    Dim fileUploader = New FileUploader() With {
        .Width = 600,
        .Height = 300,
        .Resizable = True,
        .UploadLocation = "~/App_Data/Uploads"
    }
End Code
<html>
    <head>
        <title>File Uploader</title>
        @Me.RenderHead(fileUploader)
    </head>
    <body>
        @Me.RenderBody(fileUploader)
    </body>
</html>