Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
public static final class

ContactsContract.RawContacts.Entity

extends Object
implements BaseColumns ContactsContract.DataColumns
java.lang.Object
   ↳ android.provider.ContactsContract.RawContacts.Entity

Class Overview

A sub-directory of a single raw contact that contains all of its ContactsContract.Data rows. To access this directory append CONTENT_DIRECTORY to the raw contact URI. See ContactsContract.RawContactsEntity for a stand-alone table containing the same data.

Entity has two ID fields: _ID for the raw contact and DATA_ID for the data rows. Entity always contains at least one row, even if there are no actual data rows. In this case the DATA_ID field will be null.

Using Entity should be preferred to using two separate queries: RawContacts followed by Data. The reason is that Entity reads all data for a raw contact in one transaction, so there is no possibility of the data changing between the two queries.

Summary

Constants
String CONTENT_DIRECTORY The directory twig for this sub-table
String DATA_ID The ID of the data row.
[Expand]
Inherited Constants
From interface android.provider.BaseColumns
From interface android.provider.ContactsContract.DataColumns
[Expand]
Inherited Methods
From class java.lang.Object

Constants

public static final String CONTENT_DIRECTORY

Added in API level 5

The directory twig for this sub-table

Constant Value: "entity"

public static final String DATA_ID

Added in API level 5

The ID of the data row. The value will be null if this raw contact has no data rows.

Type: INTEGER

Constant Value: "data_id"