Class UsageStatistics

This class provides APIs to query the application launch history.

Inheritance

Object

AppStatistics

UsageStatistics

Inherited Members

Object.Equals(Object)

Object.Equals(Object, Object)

Object.GetHashCode()

Object.GetType()

Object.MemberwiseClone()

Object.ReferenceEquals(Object, Object)

Object.ToString()

Namespace: Tizen.Context.AppHistory

Assembly: Tizen.Context.dll

Syntax

public class UsageStatistics : AppStatistics

Constructors

UsageStatistics()

The default constructor of UsageStatistics class.

Declaration

public UsageStatistics()

API Version

Feature

http://tizen.org/feature/app_history

Exceptions

Type	Condition
InvalidOperationException	Thrown when the method failed due to an internal error.
NotSupportedException	Thrown when the feature is not supported.

UsageStatistics(UsageStatistics.SortOrderType)

The constructor of UsageStatistics class.

Declaration

public UsageStatistics(UsageStatistics.SortOrderType order)

Parameters

Type	Name	Description
UsageStatistics.SortOrderType	order	The criteria of the usage statistics sorted by.

API Version

Feature

http://tizen.org/feature/app_history

Exceptions

Type	Condition
ArgumentException	Thrown when an invalid argument is used.
InvalidOperationException	Thrown when the method failed due to an internal error.
NotSupportedException	Thrown when the feature is not supported.

Properties

SortOrder

Gets the criteria of usage statistics sorted by.

Declaration

public UsageStatistics.SortOrderType SortOrder { get; }

Property Value

Type	Description
UsageStatistics.SortOrderType	The criteria of usage statistics sorted by.

API Version

Methods

Query(DateTime, DateTime)

Retrieves a given type of usage statistics.

Declaration

public IReadOnlyList<UsageStatisticsData> Query(DateTime startTime, DateTime endTime)

Parameters

Type	Name	Description
DateTime	startTime	The start time of the data to be aggregated.
DateTime	endTime	The end time of the data to be aggregated.

Returns

Type	Description
IReadOnlyList<UsageStatisticsData>	Usage statistics data retrieved.

API Version

Privilege Level

public

Privilege

http://tizen.org/privilege/apphistory.read

Feature

http://tizen.org/feature/app_history

Exceptions

Type	Condition
ArgumentException	Thrown when an invalid argument is used.
InvalidOperationException	Thrown when an invalid operation occurs.
NotSupportedException	Thrown when the feature is not supported.
UnauthorizedAccessException	Thrown when the application has no privilege to retrieve the application history.

Query(DateTime, DateTime, UInt32)

Retrieves a given type of usage statistics.

Declaration

public IReadOnlyList<UsageStatisticsData> Query(DateTime startTime, DateTime endTime, uint resultSize)

Parameters

Type	Name	Description
DateTime	startTime	The start time of the data to be aggregated.
DateTime	endTime	The end time of the data to be aggregated.
UInt32	resultSize	The number of data records to be retrieved.

Returns

Type	Description
IReadOnlyList<UsageStatisticsData>	Usage statistics data retrieved.

API Version

Privilege Level

public

Privilege

http://tizen.org/privilege/apphistory.read

Feature

http://tizen.org/feature/app_history

Exceptions

Type	Condition
ArgumentException	Thrown when an invalid argument is used.
InvalidOperationException	Thrown when an invalid operation occurs.
NotSupportedException	Thrown when the feature is not supported.
UnauthorizedAccessException	Thrown when the application has no privilege to retrieve the application history.