Class UsageStatistics

Definition

Namespace:
Tizen.Context.AppHistory
Assembly:
Tizen.Context.dll
API Level:
4

This class provides APIs to query the application launch history.

C#
Copy
public class UsageStatistics : AppStatistics
Inheritance
UsageStatistics

Constructors

View Source

UsageStatistics()

The default constructor of UsageStatistics class.

Declaration
C#
Copy
public UsageStatistics()
Exceptions
Type Condition
InvalidOperationException

Thrown when the method failed due to an internal error.

System.NotSupportedException

Thrown when the feature is not supported.

API Level: 4
Feature: http://tizen.org/feature/app_history
View Source

UsageStatistics(UsageStatistics.SortOrderType)

The constructor of UsageStatistics class.

Declaration
C#
Copy
public UsageStatistics(UsageStatistics.SortOrderType order)
Parameters
Type Name Description
UsageStatistics.SortOrderType order

The criteria of the usage statistics sorted by.

Exceptions
Type Condition
System.ArgumentException

Thrown when an invalid argument is used.

InvalidOperationException

Thrown when the method failed due to an internal error.

System.NotSupportedException

Thrown when the feature is not supported.

API Level: 4
Feature: http://tizen.org/feature/app_history

Properties

View Source

SortOrder

Gets the criteria of usage statistics sorted by.

Declaration
C#
Copy
public UsageStatistics.SortOrderType SortOrder { get; }
Property Value
Type Description
UsageStatistics.SortOrderType

The criteria of usage statistics sorted by.

API Level: 4

Methods

View Source

Query(DateTime, DateTime)

Retrieves a given type of usage statistics.

Declaration
C#
Copy
public IReadOnlyList<UsageStatisticsData> Query(DateTime startTime, DateTime endTime)
Parameters
Type Name Description
System.DateTime startTime

The start time of the data to be aggregated.

System.DateTime endTime

The end time of the data to be aggregated.

Returns
Type Description
IReadOnlyList<UsageStatisticsData>

Usage statistics data retrieved.

Exceptions
Type Condition
System.ArgumentException

Thrown when an invalid argument is used.

InvalidOperationException

Thrown when an invalid operation occurs.

System.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
View Source

Query(DateTime, DateTime, UInt32)

Retrieves a given type of usage statistics.

Declaration
C#
Copy
public IReadOnlyList<UsageStatisticsData> Query(DateTime startTime, DateTime endTime, uint resultSize)
Parameters
Type Name Description
System.DateTime startTime

The start time of the data to be aggregated.

System.DateTime endTime

The end time of the data to be aggregated.

System.UInt32 resultSize

The number of data records to be retrieved.

Returns
Type Description
IReadOnlyList<UsageStatisticsData>

Usage statistics data retrieved.

Exceptions
Type Condition
System.ArgumentException

Thrown when an invalid argument is used.

InvalidOperationException

Thrown when an invalid operation occurs.

System.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