Added in API level 5

RawContactsEntity

---

Kotlin |Java

class RawContactsEntity : BaseColumns, ContactsContract.DataColumns, ContactsContract.RawContactsColumns

kotlin.Any
↳	android.provider.ContactsContract.RawContactsEntity

Constants for the raw contacts entities table, which can be thought of as an outer join of the raw_contacts table with the data table. It is a strictly read-only table.

If a raw contact has data rows, the RawContactsEntity cursor will contain a one row for each data row. If the raw contact has no data rows, the cursor will still contain one row with the raw contact-level information and nulls for data columns.

Uri entityUri = ContentUris.withAppendedId(RawContactsEntity.CONTENT_URI, rawContactId);
  Cursor c = getContentResolver().query(entityUri,
           new String[]{
               RawContactsEntity.SOURCE_ID,
               RawContactsEntity.DATA_ID,
               RawContactsEntity.MIMETYPE,
               RawContactsEntity.DATA1
           }, null, null, null);
  try {
      while (c.moveToNext()) {
          String sourceId = c.getString(0);
          if (!c.isNull(1)) {
              String mimeType = c.getString(2);
              String data = c.getString(3);
              ...
          }
      }
  } finally {
      c.close();
  }
  

Columns

RawContactsEntity has a combination of RawContact and Data columns.

RawContacts
long	_ID	read-only	Raw contact row ID. See RawContacts.
long	CONTACT_ID	read-only	See RawContacts.
int	AGGREGATION_MODE	read-only	See RawContacts.
int	DELETED	read-only	See RawContacts.

Data
long	DATA_ID	read-only	Data row ID. It will be null if the raw contact has no data rows.
String	MIMETYPE	read-only	See ContactsContract.Data.
int	IS_PRIMARY	read-only	See ContactsContract.Data.
int	IS_SUPER_PRIMARY	read-only	See ContactsContract.Data.
int	DATA_VERSION	read-only	See ContactsContract.Data.
Any type	DATA1 DATA2 DATA3 DATA4 DATA5 DATA6 DATA7 DATA8 DATA9 DATA10 DATA11 DATA12 DATA13 DATA14 DATA15	read-only	See ContactsContract.Data.
Any type	SYNC1 SYNC2 SYNC3 SYNC4	read-only	See ContactsContract.Data.

Summary

Constants
static String	CONTENT_TYPE The MIME type of CONTENT_URI providing a directory of raw contact entities.
static String	DATA_ID The ID of the data column.

Inherited constants
From class RawContactsColumns String ACCOUNT_TYPE_AND_DATA_SET A concatenation of the account type and data set (delimited by a forward slash) - if the data set is empty, this will be the same as the account type. For applications that need to be aware of the data set, this can be used instead of account type to distinguish sets of data. This is never intended to be used for specifying accounts. This column does *not* escape forward slashes in the account type or the data set. If this is an issue, consider using ContactsContract.RawContacts.ACCOUNT_TYPE and ContactsContract.RawContacts.DATA_SET directly. String AGGREGATION_MODE The aggregation mode for this contact. Type: INTEGER String BACKUP_ID Persistent unique id for each raw_contact within its account. This id is provided by its own data source, and can be used to backup metadata to the server. This should be unique within each set of account_name/account_type/data_set String CONTACT_ID A reference to the ContactsContract.Contacts._ID that this data belongs to. Type: INTEGER String DATA_SET The data set within the account that this row belongs to. This allows multiple sync adapters for the same account type to distinguish between each others' data. This is empty by default, and is completely optional. It only needs to be populated if multiple sync adapters are entering distinct data for the same account type and account name. Type: TEXT String DELETED The "deleted" flag: "0" by default, "1" if the row has been marked for deletion. When android.content.ContentResolver#delete is called on a raw contact, it is marked for deletion and removed from its aggregate contact. The sync adaptor deletes the raw contact on the server and then calls ContactResolver.delete once more, this time passing the ContactsContract.CALLER_IS_SYNCADAPTER query parameter to finalize the data removal. Type: INTEGER String METADATA_DIRTY Flag indicating that a raw contact's metadata has changed, and its metadata needs to be synchronized by the server. Type: INTEGER (boolean) String RAW_CONTACT_IS_READ_ONLY The "read-only" flag: "0" by default, "1" if the row cannot be modified or deleted except by a sync adapter. See ContactsContract.CALLER_IS_SYNCADAPTER. Type: INTEGER String RAW_CONTACT_IS_USER_PROFILE Flag that reflects whether this raw contact belongs to the user's personal profile entry.
From class DataColumns String CARRIER_PRESENCE Carrier presence information. Type: INTEGER (A bitmask of CARRIER_PRESENCE_* fields) Int CARRIER_PRESENCE_VT_CAPABLE Indicates that the entry is Video Telephony (VT) capable on the current carrier. An allowed bitmask of CARRIER_PRESENCE. String DATA1 Generic data column, the meaning is MIMETYPE specific String DATA10 Generic data column, the meaning is MIMETYPE specific String DATA11 Generic data column, the meaning is MIMETYPE specific String DATA12 Generic data column, the meaning is MIMETYPE specific String DATA13 Generic data column, the meaning is MIMETYPE specific String DATA14 Generic data column, the meaning is MIMETYPE specific String DATA15 Generic data column, the meaning is MIMETYPE specific. By convention, this field is used to store BLOBs (binary data). String DATA2 Generic data column, the meaning is MIMETYPE specific String DATA3 Generic data column, the meaning is MIMETYPE specific String DATA4 Generic data column, the meaning is MIMETYPE specific String DATA5 Generic data column, the meaning is MIMETYPE specific String DATA6 Generic data column, the meaning is MIMETYPE specific String DATA7 Generic data column, the meaning is MIMETYPE specific String DATA8 Generic data column, the meaning is MIMETYPE specific String DATA9 Generic data column, the meaning is MIMETYPE specific String DATA_VERSION The version of this data record. This is a read-only value. The data column is guaranteed to not change without the version going up. This value is monotonically increasing. Type: INTEGER String IS_PRIMARY Whether this is the primary entry of its kind for the raw contact it belongs to. Type: INTEGER (if set, non-0 means true) String IS_READ_ONLY The "read-only" flag: "0" by default, "1" if the row cannot be modified or deleted except by a sync adapter. See ContactsContract.CALLER_IS_SYNCADAPTER. Type: INTEGER String IS_SUPER_PRIMARY Whether this is the primary entry of its kind for the aggregate contact it belongs to. Any data record that is "super primary" must also be "primary". Type: INTEGER (if set, non-0 means true) String MIMETYPE The MIME type of the item represented by this row. String PREFERRED_PHONE_ACCOUNT_COMPONENT_NAME The flattened android.content.ComponentName of a that is the preferred PhoneAccountHandle to call the contact with. On a multi-SIM device this field can be used in a CommonDataKinds.Phone row to indicate the PhoneAccountHandle to call the number with, instead of using android.telecom.TelecomManager#getDefaultOutgoingPhoneAccount(String) or asking every time. android.telecom.TelecomManager#placeCall(Uri, android.os.Bundle) should be called with android.telecom.TelecomManager#EXTRA_PHONE_ACCOUNT_HANDLE set to the PhoneAccountHandle using the ComponentName from this field. String PREFERRED_PHONE_ACCOUNT_ID The ID of a that is the preferred PhoneAccountHandle to call the contact with. Used by CommonDataKinds.Phone. On a multi-SIM device this field can be used in a CommonDataKinds.Phone row to indicate the PhoneAccountHandle to call the number with, instead of using android.telecom.TelecomManager#getDefaultOutgoingPhoneAccount(String) or asking every time. android.telecom.TelecomManager#placeCall(Uri, android.os.Bundle) should be called with android.telecom.TelecomManager#EXTRA_PHONE_ACCOUNT_HANDLE set to the PhoneAccountHandle using the id from this field. String RAW_CONTACT_ID A reference to the RawContacts._ID that this data belongs to. String RES_PACKAGE The package name to use when creating Resources objects for this data row. This value is only designed for use when building user interfaces, and should not be used to infer the owner. String SYNC1 Generic column for use by sync adapters. String SYNC2 Generic column for use by sync adapters. String SYNC3 Generic column for use by sync adapters. String SYNC4 Generic column for use by sync adapters.
From class BaseColumns String _COUNT The count of rows in a directory. Type: INTEGER String _ID The unique ID for a row. Type: INTEGER (long)

Properties
static Uri!	CONTENT_URI The content:// style URI for this table
static Uri!	PROFILE_CONTENT_URI The content:// style URI for this table, specific to the user's profile.

Constants

CONTENT_TYPE

Added in API level 5

static val CONTENT_TYPE: String

The MIME type of CONTENT_URI providing a directory of raw contact entities.

Value: "vnd.android.cursor.dir/raw_contact_entity"

DATA_ID

Added in API level 5

static val DATA_ID: String

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

Type: INTEGER

Value: "data_id"

Properties

CONTENT_URI

Added in API level 5

static val CONTENT_URI: Uri!

The content:// style URI for this table

PROFILE_CONTENT_URI

Added in API level 14

static val PROFILE_CONTENT_URI: Uri!

The content:// style URI for this table, specific to the user's profile.