Class Provider

Definition

Namespace:

Tizen.Applications.DataControl

Assembly:

Tizen.Applications.DataControl.dll

API Level:

3

Represents the Provider class for the DataControl provider application.

public abstract class Provider : IDisposable

Inheritance

Object

Provider

Implements

IDisposable

Constructors

Provider(String)

Initializes the Provider class with the dataID.

Declaration

public Provider(string dataID)

Parameters

Type	Name	Description
String	dataID	The DataControl Data ID.

Exceptions

Type	Condition
ArgumentException	Thrown in case of an invalid parameter.

API Level: 3

Properties

CurrentClientAppId

Gets the current client appid.

Declaration

public string CurrentClientAppId { get; }

Property Value

Type	Description
String

API Level: 6

CurrentProviderId

Gets the current provider ID.

Declaration

public string CurrentProviderId { get; }

Property Value

Type	Description
String

API Level: 6

DataID

Gets the data ID.

Declaration

public string DataID { get; }

Property Value

Type	Description
String

API Level: 3

Methods

Dispose()

Releases all the resources used by the Provider class.

Declaration

public void Dispose()

API Level: 3

Dispose(Boolean)

Releases unmanaged resources used by the Provider class specifying whether to perform a normal dispose operation.

Declaration

protected virtual void Dispose(bool disposing)

Parameters

Type	Name	Description
Boolean	disposing	true for a normal dispose operation; false to finalize the handle.

API Level: 3

Finalize()

Destructor of the Provider class.

Declaration

protected void Finalize()

OnBulkInsert(IEnumerable<String>, BulkData)

Overrides this method if you want to handle the behavior when the bulk insert request is received.

Declaration

protected virtual BulkInsertResult OnBulkInsert(IEnumerable<string> query, BulkData bulkInsertData)

Parameters

Type	Name	Description
IEnumerable<String>	query	The insert query list.
BulkData	bulkInsertData	The bulk insert data.

Returns

Type	Description
BulkInsertResult	The result of bulk insert operation.

API Level: 3

OnDataChangeListenRequest(String)

Overrides this method if you want to handle the behavior when the data change listen request is received.

Declaration

protected virtual DataChangeListenResult OnDataChangeListenRequest(string requestAppID)

Parameters

Type	Name	Description
String	requestAppID	The app ID sent data change listen request.

Returns

Type	Description
DataChangeListenResult	The result of data change listen operation.

API Level: 3

OnDelete(String, String)

Overrides this method if you want to handle the behavior when the delete request is received.

Declaration

protected abstract DeleteResult OnDelete(string query, string where)

Parameters

Type	Name	Description
String	query	The delete query.
String	where	The where statement.

Returns

Type	Description
DeleteResult	The result of delete operation.

API Level: 3

OnInsert(String, Bundle)

Overrides this method if you want to handle the behavior when the insert request is received.

Declaration

protected abstract InsertResult OnInsert(string query, Bundle insertData)

Parameters

Type	Name	Description
String	query	The select query.
Bundle	insertData	The insert data.

Returns

Type	Description
InsertResult	The result of insert operation.

API Level: 3

OnMapAdd(String, String)

Overrides this method if you want to handle the behavior when the map add request is received.

Declaration

protected virtual MapAddResult OnMapAdd(string key, string value)

Parameters

Type	Name	Description
String	key	The key of added data.
String	value	The value of added data.

Returns

Type	Description
MapAddResult	The result of add operation.

API Level: 3

OnMapBulkAdd(BulkData)

Overrides this method if you want to handle the behavior when the bulk add request is received.

Declaration

protected virtual MapBulkAddResult OnMapBulkAdd(BulkData bulkAddData)

Parameters

Type	Name	Description
BulkData	bulkAddData	The bulk add data.

Returns

Type	Description
MapBulkAddResult	The result of bulk add operation.

API Level: 3

OnMapGet(String)

Overrides this method if you want to handle the behavior when the map get request is received.

Declaration

protected virtual MapGetResult OnMapGet(string key)

Parameters

Type	Name	Description
String	key	The key of requested data.

Returns

Type	Description
MapGetResult	The result of get operation.

API Level: 3

OnMapRemove(String, String)

Overrides this method if you want to handle the behavior when the delete request is received.

Declaration

protected virtual MapRemoveResult OnMapRemove(string key, string value)

Parameters

Type	Name	Description
String	key	The key of removed data.
String	value	The value of removed data.

Returns

Type	Description
MapRemoveResult	The result of remove operation.

API Level: 3

OnMapSet(String, String, String)

Overrides this method if you want to handle the behavior when the update request is received.

Declaration

protected virtual MapSetResult OnMapSet(string key, string oldValue, string newValue)

Parameters

Type	Name	Description
String	key	The key of set data.
String	oldValue	The old value of set data.
String	newValue	The new value.

Returns

Type	Description
MapSetResult	The result of set operation.

API Level: 3

OnSelect(String, String, String[], Int32, String, Int32, Int32)

Overrides this method if you want to handle the behavior when the select request is received.

Declaration

protected abstract SelectResult OnSelect(string query, string where, string[] columList, int columnCount, string order, int pageNum, int countPerPage)

Parameters

Type	Name	Description
String	query	The select query.
String	where	The where statement.
String[]	columList	The requested column list.
Int32	columnCount	The requested column count.
String	order	The select order.
Int32	pageNum	The page number.
Int32	countPerPage	The count per page.

Returns

Type	Description
SelectResult	The result of select operation.

API Level: 3

OnUpdate(String, String, Bundle)

Overrides this method if you want to handle the behavior when the update request is received.

Declaration

protected abstract UpdateResult OnUpdate(string query, string where, Bundle updateData)

Parameters

Type	Name	Description
String	query	The update query.
String	where	The where statement.
Bundle	updateData	The update data.

Returns

Type	Description
UpdateResult	The result of update operation.

API Level: 3

Run()

Starts the Provider service.

Declaration

public void Run()

Remarks

Only one Provider service can be run for each process.

Exceptions

Type	Condition
UnauthorizedAccessException	Thrown in case a permission is denied.
InvalidOperationException	Thrown in case of any internal error.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/datasharing

SendDataChange(ChangeType, Bundle)

Sends a data change notification to consumer applications which have successfully added a data change listen.

Declaration

public void SendDataChange(ChangeType type, Bundle changedData)

Parameters

Type	Name	Description
ChangeType	type	The changed data type.
Bundle	changedData	Customized information about the changed data.

Exceptions

Type	Condition
ArgumentException	Thrown in case of an invalid parameter.
UnauthorizedAccessException	Thrown in case a permission is denied.
InvalidOperationException	Thrown in case of any internal error.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/datasharing

Stop()

Stops the Provider service.

Declaration

public void Stop()

API Level: 3

Implements

System.IDisposable