Class CalendarDatabase

The CalendarDatabase provides methods to manage calendar information from/to the database.

Inheritance
Object
CalendarDatabase
Inherited Members
Namespace: Tizen.Pims.Calendar
Assembly: Tizen.Pims.Calendar.dll
Syntax
public class CalendarDatabase
Remarks

This class allows user to access/create/update/delete database operations for the calendar information. The CalendarDatabase is created by the CalendarManager.

Properties

LastChangeVersion

Gets the last successful changed calendar database version on the current connection.

Declaration
public int LastChangeVersion { get; }
Property Value
Type Description
Int32

The last successful changed calendar database version on the current connection.
API Version
4
Privilege Level
public
Privilege

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

Exceptions
Type Condition
InvalidOperationException

Thrown when the method failed due to an invalid operation.
OutOfMemoryException

Thrown when failed due to out of memory.
UnauthorizedAccessException

Thrown when the application does not have proper privileges.

Version

The calendar database version.

Declaration
public int Version { get; }
Property Value
Type Description
Int32

The current calendar database version.
API Version
4

Methods

AddDBChangedDelegate(String, EventHandler<DBChangedEventArgs>)

Registers a callback function to be invoked when a record changes.

Declaration
public void AddDBChangedDelegate(string viewUri, EventHandler<DBChangedEventArgs> DBChanged)
Parameters
Type Name Description
String viewUri

The view URI of the record to subscribe for change notifications.
EventHandler<DBChangedEventArgs> DBChanged

The EventHandler to register.
API Version
4
Privilege Level
public
Privilege

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

Feature

http://tizen.org/feature/calendar

Exceptions
Type Condition
NotSupportedException

Thrown when the feature is not supported.
InvalidOperationException

Thrown when the method failed due to an invalid operation.
ArgumentException

Thrown when one of the arguments provided to a method is not valid.
OutOfMemoryException

Thrown when failed due to out of memory.
UnauthorizedAccessException

Thrown when the application does not have proper privileges.

Delete(String, Int32)

Deletes a record from the calendar database with related child records.

Declaration
public void Delete(string viewUri, int recordId)
Parameters
Type Name Description
String viewUri

The view URI of a record.
Int32 recordId

The record ID to be deleted.
API Version
4
Privilege Level
public
Privilege

http://tizen.org/privilege/calendar.write

Feature

http://tizen.org/feature/calendar

Exceptions
Type Condition
NotSupportedException

Thrown when the feature is not supported.
InvalidOperationException

Thrown when the method failed due to an invalid operation.
ArgumentException

Thrown when one of the arguments provided to a method is not valid.
OutOfMemoryException

Thrown when failed due to out of memory.
UnauthorizedAccessException

Thrown when the application does not have proper privileges.

Delete(String, Int32[])

Deletes multiple records with the related child records from the calendar database as a batch operation.

Declaration
public void Delete(string viewUri, int[] idArray)
Parameters
Type Name Description
String viewUri

The view URI of the records to delete.
Int32[] idArray

The record IDs to delete.
API Version
4
Privilege Level
public
Privilege

http://tizen.org/privilege/calendar.write

Feature

http://tizen.org/feature/calendar

Exceptions
Type Condition
NotSupportedException

Thrown when the feature is not supported.
InvalidOperationException

Thrown when the method failed due to an invalid operation.
ArgumentException

Thrown when one of the arguments provided to a method is not valid.
OutOfMemoryException

Thrown when failed due to out of memory.
UnauthorizedAccessException

Thrown when the application does not have proper privileges.

Delete(CalendarList)

Deletes multiple records with the related child records from the calendar database as a batch operation.

Declaration
public void Delete(CalendarList list)
Parameters
Type Name Description
CalendarList list

The record list.
API Version
4
Privilege Level
public
Privilege

http://tizen.org/privilege/calendar.write

Feature

http://tizen.org/feature/calendar

Exceptions
Type Condition
NotSupportedException

Thrown when the feature is not supported.
InvalidOperationException

Thrown when the method failed due to an invalid operation.
OutOfMemoryException

Thrown when failed due to out of memory.
UnauthorizedAccessException

Thrown when the application does not have proper privileges.

Get(String, Int32)

Gets a record from the calendar database.

Declaration
public CalendarRecord Get(string viewUri, int recordId)
Parameters
Type Name Description
String viewUri

The view URI of a record.
Int32 recordId

The record ID.
Returns
Type Description
CalendarRecord

The record associated with the record ID.
API Version
4
Privilege Level
public
Privilege

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

Feature

http://tizen.org/feature/calendar

Exceptions
Type Condition
NotSupportedException

Thrown when feature is not supported.
InvalidOperationException

Thrown when the method failed due to an invalid operation.
ArgumentException

Thrown when one of the arguments provided to a method is not valid.
OutOfMemoryException

Thrown when failed due to out of memory.
UnauthorizedAccessException

Thrown when the application does not have proper privileges.

GetAll(String, Int32, Int32)

Retrieves all the records as a list.

Declaration
public CalendarList GetAll(string viewUri, int offset, int limit)
Parameters
Type Name Description
String viewUri

The view URI to get records from.
Int32 offset

The index from which results are received.
Int32 limit

The maximum number of results (value 0 is used for all the records).
Returns
Type Description
CalendarList

The record list.
API Version
4
Privilege Level
public
Privilege

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

Feature

http://tizen.org/feature/calendar

Exceptions
Type Condition
NotSupportedException

Thrown when the feature is not supported.
InvalidOperationException

Thrown when the method failed due to an invalid operation.
ArgumentException

Thrown when one of the arguments provided to a method is not valid.
OutOfMemoryException

Thrown when failed due to out of memory.
UnauthorizedAccessException

Thrown when the application does not have proper privileges.

GetChangesByVersion(String, Int32, Int32, out Int32)

Retrieves the records with the given calendar database version.

Declaration
public CalendarList GetChangesByVersion(string viewUri, int BookId, int calendarDBVersion, out int currentDBVersion)
Parameters
Type Name Description
String viewUri

The view URI to get records from.
Int32 BookId

The calendar book ID to filter.
Int32 calendarDBVersion

The calendar database version.
Int32 currentDBVersion

The current calendar database version.
Returns
Type Description
CalendarList

The record list.
API Version
4
Privilege Level
public
Privilege

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

Feature

http://tizen.org/feature/calendar

Exceptions
Type Condition
NotSupportedException

Thrown when the feature is not supported.
InvalidOperationException

Thrown when the method failed due to an invalid operation.
ArgumentException

Thrown when one of the arguments provided to a method is not valid.
OutOfMemoryException

Thrown when failed due to out of memory.
UnauthorizedAccessException

Thrown when the application does not have proper privileges.

GetCount(String)

Gets the record count of a specific view.

Declaration
public int GetCount(string viewUri)
Parameters
Type Name Description
String viewUri

The view URI to get records from.
Returns
Type Description
Int32

The count of records.
API Version
4
Privilege Level
public
Privilege

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

GetCount(CalendarQuery)

Gets the record count with a query.

Declaration
public int GetCount(CalendarQuery query)
Parameters
Type Name Description
CalendarQuery query

The query used for filtering the results.
Returns
Type Description
Int32

The count of records.
API Version
4
Privilege Level
public
Privilege

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

GetRecordsWithQuery(CalendarQuery, Int32, Int32)

Retrieves the records using a query.

Declaration
public CalendarList GetRecordsWithQuery(CalendarQuery query, int offset, int limit)
Parameters
Type Name Description
CalendarQuery query

The query used to filter results.
Int32 offset

The index from which results are received.
Int32 limit

The maximum number of results (value 0 is used for all the records).
Returns
Type Description
CalendarList

CalendarList.
API Version
4
Privilege Level
public
Privilege

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

Feature

http://tizen.org/feature/calendar

Exceptions
Type Condition
NotSupportedException

Thrown when the feature is not supported.
InvalidOperationException

Thrown when the method failed due to an invalid operation.
OutOfMemoryException

Thrown when failed due to out of memory.
UnauthorizedAccessException

Thrown when the application does not have proper privileges.

Insert(CalendarList)

Inserts multiple records into the calendar database as a batch operation.

Declaration
public int[] Insert(CalendarList list)
Parameters
Type Name Description
CalendarList list

The record list.
Returns
Type Description
Int32[]

The inserted record ID array.
API Version
4
Privilege Level
public
Privilege

http://tizen.org/privilege/calendar.write

Feature

http://tizen.org/feature/calendar

Exceptions
Type Condition
NotSupportedException

Thrown when the feature is not supported.
InvalidOperationException

Thrown when the method failed due to an invalid operation.
ArgumentException

Thrown when one of the arguments provided to a method is not valid.
OutOfMemoryException

Thrown when failed due to out of memory.
UnauthorizedAccessException

Thrown when the application does not have proper privileges.

Insert(CalendarRecord)

Inserts a record into the calendar database.

Declaration
public int Insert(CalendarRecord record)
Parameters
Type Name Description
CalendarRecord record

The record to be inserted.
Returns
Type Description
Int32

The ID of inserted record.
API Version
4
Privilege Level
public
Privilege

http://tizen.org/privilege/calendar.write

Feature

http://tizen.org/feature/calendar

Exceptions
Type Condition
NotSupportedException

Thrown when the feature is not supported.
InvalidOperationException

Thrown when the method failed due to an invalid operation.
ArgumentException

Thrown when one of the arguments provided to a method is not valid.
OutOfMemoryException

Thrown when failed due to out of memory.
UnauthorizedAccessException

Thrown when the application does not have proper privileges.

LinkRecord(Int32, Int32)

Links a record to another record.

Declaration
public void LinkRecord(int baseId, int recordId)
Parameters
Type Name Description
Int32 baseId

The base record ID.
Int32 recordId

The record ID to link to.
API Version
4
Privilege Level
public
Privilege

http://tizen.org/privilege/calendar.write

Feature

http://tizen.org/feature/calendar

Exceptions
Type Condition
NotSupportedException

Thrown when the feature is not supported.
InvalidOperationException

Thrown when the method failed due to an invalid operation.
ArgumentException

Thrown when one of the arguments provided to a method is not valid.
OutOfMemoryException

Thrown when failed due to out of memory.
UnauthorizedAccessException

Thrown when the application does not have proper privileges.

RemoveDBChangedDelegate(String, EventHandler<DBChangedEventArgs>)

Deregisters a callback function.

Declaration
public void RemoveDBChangedDelegate(string viewUri, EventHandler<DBChangedEventArgs> DBChanged)
Parameters
Type Name Description
String viewUri

The view URI of the record to subscribe for change notifications.
EventHandler<DBChangedEventArgs> DBChanged

The EventHandler to deregister.
API Version
4
Privilege Level
public
Privilege

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

Feature

http://tizen.org/feature/calendar

Exceptions
Type Condition
NotSupportedException

Thrown when the feature is not supported.
InvalidOperationException

Thrown when the method failed due to an invalid operation.
OutOfMemoryException

Thrown when failed due to out of memory.
UnauthorizedAccessException

Thrown when the application does not have proper privileges.

Replace(CalendarList, Int32[])

Replaces multiple records in the calendar database as a batch operation.

Declaration
public void Replace(CalendarList list, int[] idArray)
Parameters
Type Name Description
CalendarList list

The record list.
Int32[] idArray

The record IDs.
API Version
4
Privilege Level
public
Privilege

http://tizen.org/privilege/calendar.write

Feature

http://tizen.org/feature/calendar

Exceptions
Type Condition
NotSupportedException

Thrown when the feature is not supported.
InvalidOperationException

Thrown when the method failed due to an invalid operation.
ArgumentException

Thrown when one of the arguments provided to a method is not valid.
OutOfMemoryException

Thrown when failed due to out of memory.
UnauthorizedAccessException

Thrown when the application does not have proper privileges.

Replace(CalendarRecord, Int32)

Replaces a record in the calendar database.

Declaration
public void Replace(CalendarRecord record, int id)
Parameters
Type Name Description
CalendarRecord record

The record to be replaced.
Int32 id

The record ID.
API Version
4
Privilege Level
public
Privilege

http://tizen.org/privilege/calendar.write

Feature

http://tizen.org/feature/calendar

Exceptions
Type Condition
NotSupportedException

Thrown when the feature is not supported.
InvalidOperationException

Thrown when the method failed due to an invalid operation.
ArgumentException

Thrown when one of the arguments provided to a method is not valid.
OutOfMemoryException

Thrown when failed due to out of memory.
UnauthorizedAccessException

Thrown when the application does not have proper privileges.

UnlinkRecord(Int32)

Unlinks a record from the base record.

Declaration
public void UnlinkRecord(int recordId)
Parameters
Type Name Description
Int32 recordId

The record ID to unlink.
API Version
4
Privilege Level
public
Privilege

http://tizen.org/privilege/calendar.write

Feature

http://tizen.org/feature/calendar

Exceptions
Type Condition
NotSupportedException

Thrown when the feature is not supported.
InvalidOperationException

Thrown when the method failed due to an invalid operation.
ArgumentException

Thrown when one of the arguments provided to a method is not valid.
OutOfMemoryException

Thrown when failed due to out of memory.
UnauthorizedAccessException

Thrown when the application does not have proper privileges.

Update(CalendarList)

Updates multiple records into the calendar database as a batch operation.

Declaration
public void Update(CalendarList list)
Parameters
Type Name Description
CalendarList list

The record list.
API Version
4
Privilege Level
public
Privilege

http://tizen.org/privilege/calendar.write

Feature

http://tizen.org/feature/calendar

Exceptions
Type Condition
NotSupportedException

Thrown when the feature is not supported.
InvalidOperationException

Thrown when the method failed due to an invalid operation.
ArgumentException

Thrown when one of the arguments provided to a method is not valid.
OutOfMemoryException

Thrown when failed due to out of memory.
UnauthorizedAccessException

Thrown when the application does not have proper privileges.

Update(CalendarRecord)

Updates a record in the calendar database.

Declaration
public void Update(CalendarRecord record)
Parameters
Type Name Description
CalendarRecord record

The record to be updated.
API Version
4
Privilege Level
public
Privilege

http://tizen.org/privilege/calendar.write

Feature

http://tizen.org/feature/calendar

Exceptions
Type Condition
NotSupportedException

Thrown when the feature is not supported.
InvalidOperationException

Thrown when the method failed due to an invalid operation.
ArgumentException

Thrown when one of the arguments provided to a method is not valid.
OutOfMemoryException

Thrown when failed due to out of memory.
UnauthorizedAccessException

Thrown when the application does not have proper privileges.