Skip to content

Most visited

Recently visited



public static final class ContactsContract.RawContacts.Entity
extends Object implements BaseColumns, ContactsContract.DataColumns

   ↳ android.provider.ContactsContract.RawContacts.Entity

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.




The directory twig for this sub-table

String DATA_ID

The ID of the data row.

Inherited constants

Inherited methods



added in API level 5

The directory twig for this sub-table

Constant Value: "entity"


added in API level 5
String DATA_ID

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


Constant Value: "data_id"

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields


Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience. (April 2018 — Developer Survey)