to top
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"