Querying document libraries
The examples below show you how to query all of the available document libraries or how to query only a specific document library by itsID.
Querying a single document library
To query a specific document library by its ID, you must perform the following:
-
Get the document library.
First, get an instance of the document library with the specified ID.
-
Return the document library.
Return the document library.
The following code queries a document library by its ID.
Native API
private DocumentLibrary GetDocumentLibraryNativeAPI(Guid documentLibraryId)
{
LibrariesManager librariesManager = LibrariesManager.GetManager();
DocumentLibrary library = librariesManager.GetDocumentLibraries().Where(l => l.Id == documentLibraryId).FirstOrDefault();
return library;
}
First, you get an instance of the LibrariesManager class. To get the specified document library, you query all document libraries and filter the collection by the ID property. If the specified document library does not exist, the query will return null. Finally, you return the document library.
You can also use the following code to retrieve the document library:
DocumentLibrary library = librariesManager.GetDocumentLibrary(documentLibraryId);
Note that if the document library does not exist, an exception of type ItemNotFoundException is thrown.
Fluent API
private DocumentLibrary GetDocumentLibraryFluentAPI(Guid documentLibraryId)
{
return App.WorkWith().DocumentLibrary(documentLibraryId).Get();
}
First, you get the singular facade of the document library with the specified ID. To get an instance of the document library, you call the Getmethod of the facade. Note that when the document library does not exist, an exception of type ItemNotFoundException is thrown.
You can also use the following code to retrieve the document library:
DocumentLibrary library = App.WorkWith().DocumentLibraries().Where(l => l.Id == documentLibraryId).Get().SingleOrDefault();
Querying all document libraries
When querying all document libraries, you must perform the following:
-
Query all document libraries.
First, get a query of all available document libraries.
-
Return the document libraries.
Return a list of document libraries.
The following code queries all document libraries.
Native API
private List<DocumentLibrary> GetAllDocumentLibrariesNativeAPI()
{
LibrariesManager librariesManager = LibrariesManager.GetManager();
return librariesManager.GetDocumentLibraries().ToList();
}
First, you get an instance of the LibrariesManager class. Then, you query all available document libraries. Finally, you return the document libraries as a list. If no document libraries exist, the list will be empty.
Fluent API
private List<DocumentLibrary> GetAllDocumentLibrariesFluentAPI()
{
return App.WorkWith().DocumentLibraries().Get().ToList();
}
First, you get an instance of the plural document libraries facade. Then, you get all available document libraries. Finally, you return the document libraries as a list. If no document libraries exist, the list will be empty.
See Also