FileManagerDetailsColumn.ItemTemplate Property

Gets or sets a common template used for displaying the content of all items within the current details view column.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v24.1.dll

NuGet Package: DevExpress.Web

Declaration

C#

[DefaultValue(null)]
public virtual ITemplate ItemTemplate { get; set; }

VB.NET

<DefaultValue(Nothing)>
Public Overridable Property ItemTemplate As ITemplate

Property Value

Type	Default	Description
ITemplate	null	An object supporting the ITemplate interface, which contains the template.

Remarks

Use the ItemTemplate property to define a common content for all items displayed within the current details view column. The template created using this property replaces the content of each item, preserving its style settings (if specified).

You can specify an item template for thumbnails view mode using the FileManagerFileListThumbnailsViewSettings.ItemTemplate property.

Run Demo: File Manager - Templates

Note

Once a template defined via the ItemTemplate property is created within a control, it is instantiated within a container object of the FileManagerDetailsViewItemTemplateContainer type. This container object exposes a set of specific properties to which the template’s child controls can be bound.

Example: A simple implementation of ItemTemplate for the Details View

<dx:ASPxFileManager ID="ASPxFileManager1" runat="server">
    <Settings RootFolder="~\Root" ThumbnailFolder="~\Thumb\" InitialFolder="Images\Employees\" />
    <SettingsFileList View="Details" ShowFolders="true" ShowParentFolder="true">
        <DetailsViewSettings ThumbnailHeight="75" ThumbnailWidth="75">
            <Columns>
                <dx:FileManagerDetailsColumn FileInfoType="Thumbnail" VisibleIndex="0"/>
                <dx:FileManagerDetailsColumn Caption="Name">
                    <ItemTemplate>
                        <dx:ASPxLabel runat="server" Text='<%# GetItemName(Container.Item) %>' />
                    </ItemTemplate>
                </dx:FileManagerDetailsColumn>
                <dx:FileManagerDetailsColumn Caption="Type">
                    <ItemTemplate>
                        <dx:ASPxLabel runat="server" Text='<%# GetItemType(Container.Item) %>' />
                    </ItemTemplate>
                </dx:FileManagerDetailsColumn>
                <dx:FileManagerDetailsColumn Caption="Size">
                    <ItemTemplate>
                        <dx:ASPxLabel runat="server" Text='<%# GetSize(Container.Item) %>' />
                    </ItemTemplate>
                </dx:FileManagerDetailsColumn>
            </Columns>
        </DetailsViewSettings>
    </SettingsFileList>
</dx:ASPxFileManager>

C#

Dictionary<String, String> extensionsDisplayName;

Dictionary<String, String> ExtensionsDisplayName {
    get {
        if (extensionsDisplayName == null) {
            extensionsDisplayName = new Dictionary<String, String>();
            extensionsDisplayName.Add(".txt", "Text Document (.txt)");
            extensionsDisplayName.Add(".rtf", "Rich Text Document (.rtf)");
            extensionsDisplayName.Add(".xml", "XML File (.xml)");
            extensionsDisplayName.Add(".png", "PNG image (.png)");
            extensionsDisplayName.Add(".jpg", "JPEG image (.jpg)");
            extensionsDisplayName.Add(".mp3", "MPEG Layer 3 Audio File (.mp3)");
            extensionsDisplayName.Add(".avi", "AVI File (.avi)");
            extensionsDisplayName.Add(".zip", "Compressed (zipped) Folder (.zip)");
        }
        return extensionsDisplayName;
    }
}

public string GetItemName(FileManagerItem item) {
    if (item == null)
        return String.Empty;
    FileManagerFile file = item as FileManagerFile;
    if (file != null)
        return Path.GetFileNameWithoutExtension(file.RelativeName);
    else
        return item.Name;
}
public string GetItemType(FileManagerItem item) {
    if (item == null) return String.Empty;
    FileManagerFile file = item as FileManagerFile;
    if (file != null) {
        if (ExtensionsDisplayName.ContainsKey(file.Extension))
            return ExtensionsDisplayName[file.Extension];
    }
    else {
        return item.Name.Equals("..") ? String.Empty : "Folder";
    }
    return String.Empty;
}

public string GetSize(FileManagerItem item) {
    if (item == null) return String.Empty;
    FileManagerFolder folder = item as FileManagerFolder;
    if (folder != null) {
        if (folder.Name.Equals(".."))
            return String.Empty;
        else
            return string.Format("{0:f} Kb", CountFolderSize(folder) / 1024);
    }
    return item.Length / 1024 + " Kb";
}

private float CountFolderSize(FileManagerFolder folder, float length = 0) {
    FileManagerFile[] files = folder.GetFiles();
    foreach (FileManagerFile file in files)
        length += file.Length;

    FileManagerFolder[] folders = folder.GetFolders();
    foreach (FileManagerFolder childFolder in folders)
        length = CountFolderSize(childFolder, length);
    return length;
}

VB

Private extensionsDisplayName_Renamed As Dictionary(Of String, String)

Private ReadOnly Property ExtensionsDisplayName() As Dictionary(Of String, String)
    Get
        If extensionsDisplayName_Renamed Is Nothing Then
            extensionsDisplayName_Renamed = New Dictionary(Of String, String)()
            extensionsDisplayName_Renamed.Add(".txt", "Text Document (.txt)")
            extensionsDisplayName_Renamed.Add(".rtf", "Rich Text Document (.rtf)")
            extensionsDisplayName_Renamed.Add(".xml", "XML File (.xml)")
            extensionsDisplayName_Renamed.Add(".png", "PNG image (.png)")
            extensionsDisplayName_Renamed.Add(".jpg", "JPEG image (.jpg)")
            extensionsDisplayName_Renamed.Add(".mp3", "MPEG Layer 3 Audio File (.mp3)")
            extensionsDisplayName_Renamed.Add(".avi", "AVI File (.avi)")
            extensionsDisplayName_Renamed.Add(".zip", "Compressed (zipped) Folder (.zip)")
        End If
        Return extensionsDisplayName_Renamed
    End Get
End Property

Public Function GetItemName(ByVal item As FileManagerItem) As String
    If item Is Nothing Then
        Return String.Empty
    End If
    Dim file As FileManagerFile = TryCast(item, FileManagerFile)
    If file IsNot Nothing Then
        Return Path.GetFileNameWithoutExtension(file.RelativeName)
    Else
        Return item.Name
    End If
End Function
Public Function GetItemType(ByVal item As FileManagerItem) As String
    If item Is Nothing Then
        Return String.Empty
    End If
    Dim file As FileManagerFile = TryCast(item, FileManagerFile)
    If file IsNot Nothing Then
        If ExtensionsDisplayName.ContainsKey(file.Extension) Then
            Return ExtensionsDisplayName(file.Extension)
        End If
    Else
        Return If(item.Name.Equals(".."), String.Empty, "Folder")
    End If
    Return String.Empty
End Function

Public Function GetSize(ByVal item As FileManagerItem) As String
    If item Is Nothing Then
        Return String.Empty
    End If
    Dim folder As FileManagerFolder = TryCast(item, FileManagerFolder)
    If folder IsNot Nothing Then
        If folder.Name.Equals("..") Then
            Return String.Empty
        Else
            Return String.Format("{0:f} Kb", CountFolderSize(folder) / 1024)
        End If
    End If
    Return item.Length \ 1024 & " Kb"
End Function

Private Function CountFolderSize(ByVal folder As FileManagerFolder, Optional ByVal length As Single = 0) As Single
    Dim files() As FileManagerFile = folder.GetFiles()
    For Each file As FileManagerFile In files
        length += file.Length
    Next file

    Dim folders() As FileManagerFolder = folder.GetFolders()
    For Each childFolder As FileManagerFolder In folders
        length = CountFolderSize(childFolder, length)
    Next childFolder
    Return length
End Function