Topics

All topics

Development

    Modify document libraries

    NEW TO SITEFINITY?

    To modify a document library, you must perform the following:

    1. Get the document library.

      Get an instance of the document library that you want to modify.

    2. Modify the document library.

      Set the properties of the library to the new values.

    3. Save the document library.

      Save the changes that have been made to the document library.

    The example below shows you how to modify a document library by its ID.

    Modifying a document library by its ID

    The following code modifies a document library by its ID.

    Native API
    using System;
    using System.Linq;
    using System.Text.RegularExpressions;
    using Telerik.Sitefinity.Libraries.Model;
    using Telerik.Sitefinity.Modules.Libraries;
    namespace Telerik.Sitefinity.Documentation.CodeSnippets.DevGuide.SitefinityEssentials.Modules.MediaModules.DocumentsAndFiles.ManagingLibraries
    {
    public partial class LibrariesSnippets
    {
    private void ModifyDocumentLibraryNativeAPI(Guid documentLibraryId, string newTitle)
    {
    LibrariesManager librariesManager = LibrariesManager.GetManager();
    //Get the library.
    DocumentLibrary library = librariesManager.GetDocumentLibraries().Where(b => b.Id == documentLibraryId).FirstOrDefault();
    if (library != null)
    {
    //Modify the library.
    library.Title = newTitle;
    library.LastModified = DateTime.UtcNow;
    library.Urls.Clear();
    library.UrlName = Regex.Replace(newTitle.ToLower(), @"[^\w\-\!\$\'\(\)\=\@\d_]+", "-");
    //Recompiles and validates the url of the library.
    librariesManager.RecompileAndValidateUrls(library);
    //Save the changes.
    librariesManager.SaveChanges();
    }
    }
    }
    }
    view raw ModifyLibraryNativeAPI.cs hosted with ❤ by GitHub

    First, you get an instance of the LibrariesManager class. Then, you get the document library with the specified ID. You update the values of the properties of the document library. In this example you modify the title of the document library and its URL. Finally, you call SaveChanges to persist the changes.

    Fluent API
    using System;
    using System.Collections.Generic;
    using System.Linq;
    using System.Text;
    using System.Text.RegularExpressions;
    using System.Threading.Tasks;
    namespace Telerik.Sitefinity.Documentation.CodeSnippets.DevGuide.SitefinityEssentials.Modules.MediaModules.DocumentsAndFiles.ManagingLibraries
    {
    public partial class LibrariesSnippets
    {
    private void ModifyDocumentLibraryFluentAPI(Guid documentLibraryId, string newTitle)
    {
    var count = 0;
    App.WorkWith().DocumentLibraries().Where(b => b.Id == documentLibraryId).Count(out count);
    if (count > 0)
    {
    App.WorkWith().DocumentLibrary(documentLibraryId).Do(library =>
    {
    library.Title = newTitle;
    library.LastModified = DateTime.UtcNow;
    library.Urls.Clear();
    library.UrlName = Regex.Replace(newTitle.ToLower(), @"[^\w\-\!\$\'\(\)\=\@\d_]+", "-");
    }).SaveChanges();
    }
    }
    }
    }
    view raw ModifyLibraryFluentAPI.cs hosted with ❤ by GitHub

    First, you check whether a document library with the specified ID exists. Then, you get the singular facade of the document library with the specified ID. To modify the document library, you call the Do method of the facade. In this example you update the title of the document library and its URL. Finally, to save the changes, you call the SaveChanges method of the facade.

    Want to learn more?

    Increase your Sitefinity skills by signing up for our free trainings. Get Sitefinity-certified at Progress Education Community to boost your credentials.

    Get started with Integration Hub | Sitefinity Cloud | Sitefinity SaaS

    This free lesson teaches administrators, marketers, and other business professionals how to use the Integration hub service to create automated workflows between Sitefinity and other business systems.

    Web Security for Sitefinity Administrators

    This free lesson teaches administrators the basics about protecting yor Sitefinity instance and its sites from external threats. Configure HTTPS, SSL, allow lists for trusted sites, and cookie security, among others.

    Foundations of Sitefinity ASP.NET Core Development

    The free on-demand video course teaches developers how to use Sitefinity .NET Core and leverage its decoupled architecture and new way of coding against the platform.

    Was this article helpful?

    Next article

    Delete document libraries