Get folders

Development

1. This example demonstrates how a folder can be retrieved by its id
   
   

   	using Telerik.Sitefinity.Modules.Libraries;
   	namespace Telerik.Sitefinity.Documentation.CodeSnippets.DevGuide.SitefinityEssentials.Modules.MediaModules.Folders.ManagingFolders
   	{
   	public partial class FoldersSnippets
   	{
   	public static IFolder FindFolderById()
   	{
   	//gets an isntance of the LibrariesManager
   	var manager = LibrariesManager.GetManager();
   	//creates an image album(library)
   	var imagesAlbum = manager.CreateAlbum();
   	imagesAlbum.Title = "ImageAlbumTitle1";
   	manager.SaveChanges();
   	//creates folder
   	var folder = manager.CreateFolder(imagesAlbum);
   	folder.Title = "FolderTitle"; ;
   	folder.Description = "Lorem ipsum dolor sit amet, consectetur adipiscing elit.";
   	folder.UrlName = "FolderName";
   	//always call the SaveChanges() method of the manager in order to commit the operation
   	manager.SaveChanges();
   	//finding the folder by id
   	var savedFolder = manager.FindFolderById(folder.Id);
   	return savedFolder;
   	}
   	}
   	}

   view raw GetFolderById.cs hosted with ❤ by GitHub
   
   Here we are using the FindFolderById method of the LibrariesManager by specifying folder id. If there is no folder with the specified id the method returns null. 
   
   
2. How to get the child folders of the specified parent folder:
   
   

   	using System.Linq;
   	using Telerik.Sitefinity.Modules.Libraries;
   	namespace Telerik.Sitefinity.Documentation.CodeSnippets.DevGuide.SitefinityEssentials.Modules.MediaModules.Folders.ManagingFolders
   	{
   	public partial class FoldersSnippets
   	{
   	public static IQueryable<IFolder> GetChildFolders()
   	{
   	//gets an isntance of the LibrariesManager
   	var manager = LibrariesManager.GetManager();
   	//creates an image album(library)
   	var imagesAlbum = manager.CreateAlbum();
   	imagesAlbum.Title = "ImageAlbumTitle1";
   	manager.SaveChanges();
   	//creates folder under the image album
   	var folder = manager.CreateFolder(imagesAlbum);
   	folder.Title = "FolderTitle";
   	folder.Description = "Lorem ipsum dolor sit amet, consectetur adipiscing elit.";
   	folder.UrlName = "FolderName";
   	//creates folder under the root folder
   	var childFolder1 = manager.CreateFolder(folder);
   	childFolder1.Title = "ChildFolderTitle1";
   	childFolder1.UrlName = "ChildFolderTitle1";
   	childFolder1.Description = "Lorem ipsum dolor sit amet, consectetur adipiscing elit.";
   	//creates another folder under the root folder
   	var childFolder2 = manager.CreateFolder(folder);
   	childFolder2.Title = "ChildFolderTitle2";
   	childFolder2.UrlName = "ChildFolderTitle2";
   	childFolder2.Description = "Lorem ipsum dolor sit amet, consectetur adipiscing elit.";
   	//always call the SaveChanges() method of the manager in order to commit the operation
   	manager.SaveChanges();
   	//gets all child folders under the root folder. They should be 2
   	var childFolders = manager.GetChildFolders(folder);
   	return childFolders;
   	}
   	}
   	}

   view raw GetChildFoldersOfParentFolder.cs hosted with ❤ by GitHub
   
   In this example we are creating first a folder by CreateFolder method of the LibrariesManager. Then we are creating two more folders that will be under the first folder. This is done by specifying the parent folder in CreateFolder method (another overload). We have to call the SaveChanges method in order to save the three folders. Finally we can get all child folders by the GetChildFolders method of LibrariesManager again by specifying the parent folder. 
   
   
3. Getting the child items of a specified parent folder as IQueryable:
   
   

   	using System.Linq;
   	using Telerik.Sitefinity.Libraries.Model;
   	using Telerik.Sitefinity.Modules.Libraries;
   	namespace Telerik.Sitefinity.Documentation.CodeSnippets.DevGuide.SitefinityEssentials.Modules.MediaModules.Folders.ManagingFolders
   	{
   	public partial class FoldersSnippets
   	{
   	public static IQueryable<MediaContent> GetChildItems()
   	{
   	var manager = LibrariesManager.GetManager();
   	var imagesAlbum = manager.CreateAlbum();
   	imagesAlbum.Title = "ImageAlbumTitle1";
   	manager.SaveChanges();
   	var folder = manager.CreateFolder(imagesAlbum);
   	var folderId = folder.Id;
   	folder.Title = "FolderTitle";
   	folder.Description = "Lorem ipsum dolor sit amet, consectetur adipiscing elit.";
   	folder.UrlName = "FolderName";
   	var childFolder1 = manager.CreateFolder(folder);
   	childFolder1.Title = "ChildFolderTitle1";
   	childFolder1.UrlName = "ChildFolderTitle1";
   	childFolder1.Description = "Lorem ipsum dolor sit amet, consectetur adipiscing elit.";
   	var image = manager.CreateImage();
   	image.Title = "imageTitle";
   	image.Parent = imagesAlbum;
   	image.FolderId = folder.Id;
   	image = manager.CreateImage();
   	image.Title = "FolderTitle";
   	image.Parent = imagesAlbum;
   	image.FolderId = childFolder1.Id;
   	manager.SaveChanges();
   	var childItemsUnderFolder = manager.GetChildItems(folder);
   	return childItemsUnderFolder;
   	}
   	}
   	}

   view raw GetChildItemsOfParentFolder.cs hosted with ❤ by GitHub
   
   This example demonstrates how to get all items under a specific folder. First we are creating an image album (could be video or document library also) via the CreateAlbum method of the LibrariesManager. For more information go to For developers: Create image libraries article. Next we are creating a folder with a child folder. For that purpose we are using two of the overloads of the CreateFolder method of the LibrariesManager. For more information go to For developers: Create folders inside libraries article. Then we are creating two images. One is under the parent folder created previously and the other under the child folder. Notice the new FolderId property introduced which specifies the id of the folder under which the image is going to be stored. Do not forget to call SaveChanges method of the LibrariesManager in order to save the folders and images. For more information on creating images go to For developers: Create images. Finally we are calling the GetChildItems method of the LibrariesManager by specifying the folder.
   
   

4. Here’s an example of getting all folders in parent library:
   
   

   	using System;
   	using System.Linq;
   	using Telerik.Sitefinity.Modules.Libraries;
   	namespace Telerik.Sitefinity.Documentation.CodeSnippets.DevGuide.SitefinityEssentials.Modules.MediaModules.Folders.ManagingFolders
   	{
   	public partial class FoldersSnippets
   	{
   	public static IQueryable<IFolder> GetAllFoldersInLibrary(Guid albumId)
   	{
   	//gets an isntance of the LibrariesManager
   	var manager = LibrariesManager.GetManager();
   	//gets the images album
   	var library = manager.GetAlbum(albumId);
   	//creates folder under the album
   	var folder = manager.CreateFolder(library);
   	folder.Title = "FolderTitle";
   	folder.Description = "Lorem ipsum dolor sit amet, consectetur adipiscing elit.";
   	folder.UrlName = "FolderName";
   	//always call the SaveChanges() method of the manager in order to commit the operation
   	manager.SaveChanges();
   	//gets all folders under the album
   	var searchResult = manager.GetAllFolders(library);
   	return searchResult;
   	}
   	}
   	}

   view raw GetAllFoldersInAlbum.cs hosted with ❤ by GitHub
   
   In this example we are creating a folder uder an album for images. The you can use the GetAllFolders method of the LibrariesManager by specifying the library as a parameter in order to find all folder under a specific library.
   
   
5. Here’s an example of getting all folders in parent folder:
   
   

   	using System;
   	using System.Linq;
   	using Telerik.Sitefinity.Modules.Libraries;
   	namespace Telerik.Sitefinity.Documentation.CodeSnippets.DevGuide.SitefinityEssentials.Modules.MediaModules.Folders.ManagingFolders
   	{
   	public partial class FoldersSnippets
   	{
   	public static IQueryable<IFolder> GetAllFoldersInFolder(Guid albumId)
   	{
   	//gets an isntance of the LibrariesManager
   	var manager = LibrariesManager.GetManager();
   	//gets the images album
   	var library = manager.GetAlbum(albumId);
   	//creates folder under the album
   	var folder = manager.CreateFolder(library);
   	var folderId = folder.Id;
   	folder.Title = "FolderTitle";
   	folder.Description = "Lorem ipsum dolor sit amet, consectetur adipiscing elit.";
   	folder.UrlName = "FolderName";
   	//always call the SaveChanges() method of the manager in order to commit the operation
   	manager.SaveChanges();
   	//gets the folder by id
   	folder = manager.GetFolder(folderId);
   	//creates another folder under the other folder
   	var subFolder = manager.CreateFolder(folder);
   	var subFolderId = subFolder.Id;
   	subFolder.Title = "FolderTitle";
   	subFolder.Description = "Lorem ipsum dolor sit amet, consectetur adipiscing elit.";
   	subFolder.UrlName = "FolderName";
   	//do not forget the SaveChanges again
   	manager.SaveChanges();
   	//getting the sub-folder by id
   	subFolder = manager.GetFolder(subFolderId);
   	//getting all the folders under a parent folder (total - 1)
   	var searchResult = manager.GetAllFolders(folder);
   	return searchResult;
   	}
   	}
   	}

   view raw GetAllFoldersInParentFolder.cs hosted with ❤ by GitHub
   
   This example is similar to number 4. However this time we have two folders with parent-child relationship within them. So the searchResult will return 2 folders in the end.