Example 1: Adding FileVistaControl via tagPrefix

Example 1: Adding FileVistaControl via tagPrefix
Example 2: Adding FileVistaControl programmatically
Example 3: Advanced features; events, user logic and subfolder permissions

This example demonstrates adding FileVistaControl to the page by using <GleamTech:FileVistaControl> tagPrefix:

,

FileVistaControl Trial Version

Here is the markup code which renders the control above:

<GleamTech:FileVistaControl ID="FileVistaControl" runat="server" 
                            Style="width: 800px; height: 600px" 
                            Language="en-US" 
                            LicenseKey=""
                            Debug="false"
                            Fullscreen="false"
                            UploadMethod="Flash">
 
    <RootFolders>
 
        <GleamTech:FileVistaRootFolder Name="Root Folder 1" 
                                       Path="C:\TestFolder\filevistacontrol\RootFolder1" 
                                       Permissions="Full" />
 
        <GleamTech:FileVistaRootFolder Name="Root Folder 2" 
                                       Path="C:\TestFolder\filevistacontrol\RootFolder2" 
                                       Permissions="Traverse, List, Download, Upload"
                                       Quota="2000 KB"
                                       AllowedFileTypes="*.jpg; *.gif" />
 
    </RootFolders>
</GleamTech:FileVistaControl>

Descriptions for the control properties:

Style property is used for setting dimensions and position of the control with CSS attributes. The control can be also absolutely positioned with attributes like "position:absolute; left:200px; top:300px;".
Language property defines the language of the user interface. If the property is set to a specific culture like de-CH (German in Switzerland), the control will first look for the language file de-CH.xml and if the file is not found, it will load the general (fallback) language file of that culture which is de.xml. If omitted, the language file which matches the current culture of the host application will be loaded. If there is no language file which matches the current culture or its fallback, then the default language file en.xml is loaded.
LicenseKey property is for setting the purchased license key to unlock the trial version. If omitted, the control will run in trial mode.
Debug property can be set to "true" for running the control in debug mode which will enable detailed error messages for troubleshooting. If omitted, the control will run in production mode.
Fullscreen property can be set to "true" for resizing the control to fit the browser window.
UploadMethod property can be set to Browser, Ajax or Flash. Flash method is the best as it allows you to select multiple files at once in the file selection dialog where Browser and Ajax methods allows you to select only one file at a time. If omitted, Flash method is used by default. Flash method will work in medium-trust level. Ajax method needs higher permissions due to displaying the realtime progress information so it will not be available in medium-trust level. Browser method will allow uploading even in medium-trust level by sacrificing the realtime progress information. Note that there is a fallback mechanism, ie. even if it is set to Flash and if Adobe Flash plugin does not exist in user's browser then the method will be degraded to Ajax or Browser upload automatically so the user will always be able to upload files with a consistent user interface.
TemporaryFolder property will control the location of the temporary files that are created during actions like "Download As Zip". If omitted, temporary files will be created in the same folder where the action occurs.
DisableFolderExpandableCheck property can be set to "true" if you are experiencing slow load times with huge folders. When building the folder tree, the control calculates if a folder is expandable or not (ie. if it should have a plus sign or not). By setting this property to true, you can disable this calculation and improve loading speed of huge folders.
MaxZipFileSize property is for limiting the size of the generated zip files on "Add to Zip" and "Download as Zip" actions. It can be set can be set in <Number> KB/MB/GB format (eg. 100 KB or 1 MB or 5 GB). If omitted, there will be no size limit for the zip files.
ShowHiddenFilesAndFolders property can be set to "true" for forcing to show hidden files and folders.
ShowSystemFilesAndFolders property can be set to "true" for forcing to show system files and folders.
ShowFileExtensions property can be set to "true" for forcing to show the extension part of the file names in the file list. When this property is enabled, the extensions will also be shown and editable in the prompt dialog boxes (eg. "Rename" and "Add to Zip" actions) too.
^New ShowSystemTypeDescriptions property can be set to "true" for for forcing to show file and folder type descriptions from the system's registry. If not enabled (default behaviour), then simple (but current language dependant) type descriptions (eg. EXE File) will be shown. Under Medium-Trust, registry access will not be possible so even if this property is enabled, simple type descriptions will be shown.

Descriptions for the root folder properties:

Root folders which are to be defined/displayed within the control, are added by using <GleamTech:FileVistaRootFolder> tagPrefix inside the sub tag of the control <RootFolders>.

Name property should be set to the display name of the root folder. This property is required and can not be omitted.
Path property should be set to the actual path of the root folder. It can be a virtual (/webfolder/test), application-relative (~/App_Data/RootFolder1), physical (d:\files) or network (\\server\share) path. This property is required and can not be omitted.
Permissions property can be set as predefined values Full (includes all permissions) or ReadOnly (includes only Traverse, List, Download, Copy permissions) or one of (or combination of) Traverse, List, Create, Delete, Rename, Edit, Upload, Download, Compress, Extract, Cut, Copy, Paste permissions. When combining permissions, they should be separated by comma. If omitted, the root folder will be completely inaccessible.
Quota property can be set in <Number> KB/MB/GB format (eg. 100 KB or 1 MB or 5 GB). If omitted, the quota will be unlimited.
AllowedFileTypes property accepts a semi-colon separated list of file extensions (eg. *.doc; *.xls; *.jpg, *.pdf) that are allowed in the root folder. This property restricts all file actions (List, Delete, Rename, Copy, Move, Extract, Compress and Download) along with Upload action. This means only allowed file types will be visible and manageable in the file list. If omitted, any file type (ie. *) is allowed. Note that you can also define the allowed file names and not the extensions only. For instance, you can use * in any part of the filename such as picture*.jpg which matches "picture34.jpg" or "picture 112.jpg" or use it in the extension such as *.jp* which matches "file.jpg", "file.jpe" or "file.jpeg".