Class TagCommand

Definition

Namespace:

Tizen.Content.MediaContent

Assembly:

Tizen.Content.MediaContent.dll

Provides the commands to manage tags in the database.

public class TagCommand : MediaCommand

Inheritance

object

MediaCommand

TagCommand

Constructors

TagCommand(MediaDatabase)

Initializes a new instance of the TagCommand class with the specified MediaDatabase.

Declaration

public TagCommand(MediaDatabase database)

Parameters

Type	Name	Description
MediaDatabase	database	The MediaDatabase that the commands run on.

Exceptions

Type	Condition
System.ArgumentNullException	database is null.
System.ObjectDisposedException	database has already been disposed of.

See Also

Tag

Methods

AddMedia(int, IEnumerable<string>)

Adds the media set to a tag.

Declaration

public bool AddMedia(int tagId, IEnumerable<string> mediaIds)

Parameters

Type	Name	Description
int	tagId	The tag ID that the media will be added to.
System.Collections.Generic.IEnumerable<T><string>	mediaIds	The media ID to add to the tag.

Returns

Type	Description
bool	true if the matched record was found and updated, otherwise false.

Remarks

The invalid media IDs will be ignored.

Exceptions

Type	Condition
System.InvalidOperationException	The MediaDatabase is disconnected.
System.ObjectDisposedException	The MediaDatabase has already been disposed of.
MediaDatabaseException	An error occurred while executing the command.
System.ArgumentNullException	mediaIds is null.
System.ArgumentException	mediaIds has no element. -or- mediaIds contains null value. -or- mediaIds contains a zero-length string, contains only white space.
System.ArgumentOutOfRangeException	tagId is less than or equal to zero.

See Also

Tag

AddMedia(int, string)

Adds the media to a tag.

Declaration

public bool AddMedia(int tagId, string mediaId)

Parameters

Type	Name	Description
int	tagId	The tag ID that the media will be added to.
string	mediaId	The media ID to add to the tag.

Returns

Type	Description
bool	true if the matched record was found and updated, otherwise false.

Remarks

The invalid media ID will be ignored.

Exceptions

Type	Condition
System.InvalidOperationException	The MediaDatabase is disconnected.
System.ObjectDisposedException	The MediaDatabase has already been disposed of.
MediaDatabaseException	An error occurred while executing the command.
System.ArgumentNullException	mediaId is null.
System.ArgumentException	mediaId is a zero-length string, contains only white space.
System.ArgumentOutOfRangeException	tagId is less than or equal to zero.

See Also

Tag

Count()

Retrieves the number of tags.

Declaration

public int Count()

Returns

Type	Description
int	The number of tags.

Exceptions

Type	Condition
System.InvalidOperationException	The MediaDatabase is disconnected.
System.ObjectDisposedException	The MediaDatabase has already been disposed of.
MediaDatabaseException	An error occurred while executing the command.

See Also

Tag

Count(CountArguments)

Retrieves the number of tags with the CountArguments.

Declaration

public int Count(CountArguments arguments)

Parameters

Type	Name	Description
CountArguments	arguments	The criteria to use to filter. This value can be null.

Returns

Type	Description
int	The number of tags filtered.

Exceptions

Type	Condition
System.InvalidOperationException	The MediaDatabase is disconnected.
System.ObjectDisposedException	The MediaDatabase has already been disposed of.
MediaDatabaseException	An error occurred while executing the command.

See Also

Tag

CountMedia(int, CountArguments)

Retrieves the number of the media information of the tag with the CountArguments.

Declaration

public int CountMedia(int tagId, CountArguments arguments)

Parameters

Type	Name	Description
int	tagId	The tag ID to query with.
CountArguments	arguments	The criteria to use to filter. This value can be null.

Returns

Type	Description
int	The number of the media information.

Exceptions

Type	Condition
System.InvalidOperationException	The MediaDatabase is disconnected.
System.ObjectDisposedException	The MediaDatabase has already been disposed of.
MediaDatabaseException	An error occurred while executing the command.
System.ArgumentOutOfRangeException	tagId is less than or equal to zero.

See Also

Tag

CountMedia(int)

Retrieves the number of media info of the tag.

Declaration

public int CountMedia(int tagId)

Parameters

Type	Name	Description
int	tagId	The tag ID.

Returns

Type	Description
int	The number of the media information.

Exceptions

Type	Condition
System.InvalidOperationException	The MediaDatabase is disconnected.
System.ObjectDisposedException	The MediaDatabase has already been disposed of.
MediaDatabaseException	An error occurred while executing the command.
System.ArgumentOutOfRangeException	tagId is less than or equal to zero.

See Also

Tag

Delete(int)

Deletes a tag from the database.

Declaration

public bool Delete(int tagId)

Parameters

Type	Name	Description
int	tagId	The tag ID to delete.

Returns

Type	Description
bool	true if the matched record was found and deleted, otherwise false.

Exceptions

Type	Condition
System.InvalidOperationException	The MediaDatabase is disconnected.
System.ObjectDisposedException	The MediaDatabase has already been disposed of.
MediaDatabaseException	An error occurred while executing the command.
System.ArgumentOutOfRangeException	tagId is less than or equal to zero.
System.UnauthorizedAccessException	The caller has no required privilege.

See Also

Tag

Insert(string)

Inserts a tag into the database with the specified name.

Declaration

public Tag Insert(string name)

Parameters

Type	Name	Description
string	name	The name of tag.

Returns

Type	Description
Tag	The Tag instance that contains the record information inserted.

Exceptions

Type	Condition
System.InvalidOperationException	The MediaDatabase is disconnected.
System.ObjectDisposedException	The MediaDatabase has already been disposed of.
MediaDatabaseException	An error occurred while executing the command.
System.ArgumentNullException	name is null.
System.UnauthorizedAccessException	The caller has no required privilege.

See Also

Tag

RemoveMedia(int, IEnumerable<string>)

Removes the media set from a tag.

Declaration

public bool RemoveMedia(int tagId, IEnumerable<string> mediaIds)

Parameters

Type	Name	Description
int	tagId	The tag ID.
System.Collections.Generic.IEnumerable<T><string>	mediaIds	The collection of media ID to remove from the tag.

Returns

Type	Description
bool	true if the matched record was found and updated, otherwise false.

Remarks

The invalid IDs will be ignored.

Exceptions

Type	Condition
System.InvalidOperationException	The MediaDatabase is disconnected.
System.ObjectDisposedException	The MediaDatabase has already been disposed of.
MediaDatabaseException	An error occurred while executing the command.
System.ArgumentNullException	mediaIds is null.
System.ArgumentException	mediaIds has no element. -or- mediaIds contains null value. -or- mediaIds contains a zero-length string or white space.
System.ArgumentOutOfRangeException	tagId is less than or equal to zero.

See Also

Tag

RemoveMedia(int, string)

Removes the media from a tag.

Declaration

public bool RemoveMedia(int tagId, string mediaId)

Parameters

Type	Name	Description
int	tagId	The tag ID.
string	mediaId	The media ID to remove from the tag.

Returns

Type	Description
bool	true if the matched record was found and updated, otherwise false.

Remarks

The invalid media ID will be ignored.

Exceptions

Type	Condition
System.InvalidOperationException	The MediaDatabase is disconnected.
System.ObjectDisposedException	The MediaDatabase has already been disposed of.
MediaDatabaseException	An error occurred while executing the command.
System.ArgumentNullException	mediaId is null.
System.ArgumentException	mediaId is a zero-length string, contains only white space.
System.ArgumentOutOfRangeException	tagId is less than or equal to zero.

See Also

Tag

Select()

Retrieves all the tags.

Declaration

public MediaDataReader<Tag> Select()

Returns

Type	Description
MediaDataReader<Tag>	The MediaDataReader<TRecord> containing the results.

Exceptions

Type	Condition
System.InvalidOperationException	The MediaDatabase is disconnected.
System.ObjectDisposedException	The MediaDatabase has already been disposed of.
MediaDatabaseException	An error occurred while executing the command.

See Also

Tag

Select(int)

Retrieves the tag with the specified ID.

Declaration

public Tag Select(int tagId)

Parameters

Type	Name	Description
int	tagId	The tag ID to select.

Returns

Type	Description
Tag	The Tag instance if the matched record was found in the database, otherwise null.

Exceptions

Type	Condition
System.InvalidOperationException	The MediaDatabase is disconnected.
System.ObjectDisposedException	The MediaDatabase has already been disposed of.
MediaDatabaseException	An error occurred while executing the command.
System.ArgumentOutOfRangeException	tagId is less than or equal to zero.

See Also

Tag

Select(SelectArguments)

Retrieves the tags with the SelectArguments.

Declaration

public MediaDataReader<Tag> Select(SelectArguments arguments)

Parameters

Type	Name	Description
SelectArguments	arguments	The criteria to use to filter. This value can be null.

Returns

Type	Description
MediaDataReader<Tag>	The MediaDataReader<TRecord> containing the results.

Exceptions

Type	Condition
System.InvalidOperationException	The MediaDatabase is disconnected.
System.ObjectDisposedException	The MediaDatabase has already been disposed of.
MediaDatabaseException	An error occurred while executing the command.

See Also

Tag

SelectMedia(int, SelectArguments)

Retrieves the media information of the tag with the SelectArguments.

Declaration

public MediaDataReader<MediaInfo> SelectMedia(int tagId, SelectArguments filter)

Parameters

Type	Name	Description
int	tagId	The tag ID.
SelectArguments	filter	The criteria to use to filter. This value can be null.

Returns

Type	Description
MediaDataReader<MediaInfo>	The MediaDataReader<TRecord> containing the results.

Exceptions

Type	Condition
System.InvalidOperationException	The MediaDatabase is disconnected.
System.ObjectDisposedException	The MediaDatabase has already been disposed of.
MediaDatabaseException	An error occurred while executing the command.
System.ArgumentOutOfRangeException	tagId is less than or equal to zero.

See Also

Tag

SelectMedia(int)

Retrieves the media information of the tag.

Declaration

public MediaDataReader<MediaInfo> SelectMedia(int tagId)

Parameters

Type	Name	Description
int	tagId	The tag ID.

Returns

Type	Description
MediaDataReader<MediaInfo>	The MediaDataReader<TRecord> containing the results.

Exceptions

Type	Condition
System.InvalidOperationException	The MediaDatabase is disconnected.
System.ObjectDisposedException	The MediaDatabase has already been disposed of.
MediaDatabaseException	An error occurred while executing the command.
System.ArgumentOutOfRangeException	tagId is less than or equal to zero.

See Also

Tag

UpdateName(int, string)

Updates a tag with the specified name.

Declaration

public bool UpdateName(int tagId, string name)

Parameters

Type	Name	Description
int	tagId	The tag ID to update.
string	name	The new name.

Returns

Type	Description
bool	true if the matched record was found and updated, otherwise false.

Exceptions

Type	Condition
System.InvalidOperationException	The MediaDatabase is disconnected.
System.ObjectDisposedException	The MediaDatabase has already been disposed of.
MediaDatabaseException	An error occurred while executing the command.
System.ArgumentNullException	name is null.
System.ArgumentOutOfRangeException	tagId is less than or equal to zero.
System.UnauthorizedAccessException	The caller has no required privilege.

See Also

Tag

See Also

Tag