Class UsageStatistics

Definition

Namespace:

Tizen.Context.AppHistory

Assembly:

Tizen.Context.dll

API Level:

4

This class provides APIs to query the application launch history.

public class UsageStatistics : AppStatistics

Inheritance

Object

AppStatistics

UsageStatistics

Constructors

UsageStatistics()

The default constructor of UsageStatistics class.

Declaration

public UsageStatistics()

Exceptions

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

API Level: 4

Feature: http://tizen.org/feature/app_history

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.

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.

API Level: 4

Feature: http://tizen.org/feature/app_history

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 Level: 4

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.

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.

API Level: 4

Privilege Level: public

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

Feature: http://tizen.org/feature/app_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.

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.

API Level: 4

Privilege Level: public

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

Feature: http://tizen.org/feature/app_history