Querying albums
The examples below show you how to query all of the available albums or how to query only a specific album by its ID.
Querying a single album
To query a specific album by its ID, you must perform the following:
-
Get the album.
First, get an instance of the album that corresponds to the specified ID.
-
Return the album.
Return the album.
The following code queries an album by its ID.
Native API
private Album GetAlbumNativeAPI(Guid albumId)
{
LibrariesManager librariesManager = LibrariesManager.GetManager();
Album album = librariesManager.GetAlbums().Where(a => a.Id == albumId).FirstOrDefault();
return album;
}
First, you get an instance of the LibrariesManager class. To get the specified album, you query all albums and filter the collection by the IDargument. If the specified album does not exist, the query will return null. Finally, you return the album.
You can also use the following code to retrieve the album:
Album album = albumsManager.GetAlbum(albumId);
Note that if the album does not exist, an exception of type ItemNotFoundException is thrown.
Fluent API
private Album GetAlbumFluentAPI(Guid albumId)
{
return App.WorkWith().Album(albumId).Get();
}
First, you get the singular facade of the album with the specified ID. To get an instance of the album, you call the Get method of the facade. Note that when the album does not exist, an exception of type ItemNotFoundException is thrown.
You can also use the following code to retrieve the album:
Album album = App.WorkWith().Albums().Where(a => a.Id == albumId).Get().SingleOrDefault();
Querying all albums
When querying all albums, you must perform the following:
-
Query all albums.
First, get a query of all available albums.
-
Return the albums.
Return a list of albums.
The following code queries all albums.
Native API
private List<Album> GetAllAlbumsNativeAPI()
{
LibrariesManager albumsManager = LibrariesManager.GetManager();
return albumsManager.GetAlbums().ToList();
}
First, you get an instance of the LibrariesManager class. Then, you query all available albums. Finally, you return the albums as a list. If no albums exist, the list will be empty.
Fluent API
private List<Album> GetAllAlbumsFluentAPI()
{
return App.WorkWith().Albums().Get().ToList();
}
First, you get an instance of the plural albums facade. Then, you get all available albums. Finally, you return the albums as a list. If no albums exist, the list will be empty.
See Also