Save the date! Android Dev Summit is coming to Mountain View, CA on November 7-8, 2018.

ContactsContract.RawContacts.Entity

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

java.lang.Object
   ↳ 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: BaseColumns._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.

Inherited constants

Inherited methods

Constants

CONTENT_DIRECTORY

added in API level 5
public static final String CONTENT_DIRECTORY

The directory twig for this sub-table

Constant Value: "entity"

DATA_ID

added in API level 5
public static final String DATA_ID

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"