Modifying document libraries
To modify a document library, you must perform the following:
-
Get the document library.
Get an instance of the document library that you want to modify.
-
Modify the document library.
Set the properties of the library to the new values.
-
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
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_]+", "-");
//Save the changes.
librariesManager.SaveChanges();
}
}
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 callSaveChanges to persist the changes.
Fluent API
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();
}
}
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.
See Also