Added in API level 5

ContactsContract.DataColumns

protected static interface ContactsContract.DataColumns

android.provider.ContactsContract.DataColumns


Columns in the Data table.

Summary

Constants

String CARRIER_PRESENCE

This constant was deprecated in API level 31. The contacts database will only show presence information on devices where CarrierConfigManager.KEY_USE_RCS_PRESENCE_BOOL is true, otherwise use RcsUceAdapter.

int CARRIER_PRESENCE_VT_CAPABLE

This constant was deprecated in API level 31. Same as DataColumns#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.

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.

String IS_PRIMARY

Whether this is the primary entry of its kind for the raw contact it belongs to.

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.

String IS_SUPER_PRIMARY

Whether this is the primary entry of its kind for the aggregate contact it belongs to.

String MIMETYPE

The MIME type of the item represented by this row.

String PREFERRED_PHONE_ACCOUNT_COMPONENT_NAME

The flattened ComponentName of a PhoneAccountHandle that is the preferred PhoneAccountHandle to call the contact with.

String PREFERRED_PHONE_ACCOUNT_ID

The ID of a PhoneAccountHandle that is the preferred PhoneAccountHandle to call the contact with.

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.

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.

Constants

CARRIER_PRESENCE

Added in API level 23
Deprecated in API level 31
public static final String CARRIER_PRESENCE

This constant was deprecated in API level 31.
The contacts database will only show presence information on devices where CarrierConfigManager.KEY_USE_RCS_PRESENCE_BOOL is true, otherwise use RcsUceAdapter.

Carrier presence information.

Type: INTEGER (A bitmask of CARRIER_PRESENCE_* fields)

Constant Value: "carrier_presence"

CARRIER_PRESENCE_VT_CAPABLE

Added in API level 23
Deprecated in API level 31
public static final int CARRIER_PRESENCE_VT_CAPABLE

This constant was deprecated in API level 31.
Same as DataColumns#CARRIER_PRESENCE.

Indicates that the entry is Video Telephony (VT) capable on the current carrier. An allowed bitmask of CARRIER_PRESENCE.

Constant Value: 1 (0x00000001)

DATA1

Added in API level 5
public static final String DATA1

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data1"

DATA10

Added in API level 5
public static final String DATA10

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data10"

DATA11

Added in API level 5
public static final String DATA11

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data11"

DATA12

Added in API level 5
public static final String DATA12

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data12"

DATA13

Added in API level 5
public static final String DATA13

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data13"

DATA14

Added in API level 5
public static final String DATA14

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data14"

DATA15

Added in API level 5
public static final String DATA15

Generic data column, the meaning is MIMETYPE specific. By convention, this field is used to store BLOBs (binary data).

Constant Value: "data15"

DATA2

Added in API level 5
public static final String DATA2

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data2"

DATA3

Added in API level 5
public static final String DATA3

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data3"

DATA4

Added in API level 5
public static final String DATA4

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data4"

DATA5

Added in API level 5
public static final String DATA5

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data5"

DATA6

Added in API level 5
public static final String DATA6

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data6"

DATA7

Added in API level 5
public static final String DATA7

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data7"

DATA8

Added in API level 5
public static final String DATA8

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data8"

DATA9

Added in API level 5
public static final String DATA9

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data9"

DATA_VERSION

Added in API level 5
public static final 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

Constant Value: "data_version"

IS_PRIMARY

Added in API level 5
public static final 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)

Constant Value: "is_primary"

IS_READ_ONLY

Added in API level 11
public static final 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

Constant Value: "is_read_only"

IS_SUPER_PRIMARY

Added in API level 5
public static final 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)

Constant Value: "is_super_primary"

MIMETYPE

Added in API level 5
public static final String MIMETYPE

The MIME type of the item represented by this row.

Constant Value: "mimetype"

PREFERRED_PHONE_ACCOUNT_COMPONENT_NAME

Added in API level 28
public static final String PREFERRED_PHONE_ACCOUNT_COMPONENT_NAME

The flattened ComponentName of a PhoneAccountHandle 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 TelecomManager.getDefaultOutgoingPhoneAccount(String) or asking every time.

TelecomManager.placeCall(Uri, android.os.Bundle) should be called with TelecomManager.EXTRA_PHONE_ACCOUNT_HANDLE set to the PhoneAccountHandle using the ComponentName from this field.

Constant Value: "preferred_phone_account_component_name"

PREFERRED_PHONE_ACCOUNT_ID

Added in API level 28
public static final String PREFERRED_PHONE_ACCOUNT_ID

The ID of a PhoneAccountHandle 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 TelecomManager.getDefaultOutgoingPhoneAccount(String) or asking every time.

TelecomManager.placeCall(Uri, android.os.Bundle) should be called with TelecomManager.EXTRA_PHONE_ACCOUNT_HANDLE set to the PhoneAccountHandle using the id from this field.

Constant Value: "preferred_phone_account_id"

RAW_CONTACT_ID

Added in API level 5
public static final String RAW_CONTACT_ID

A reference to the RawContacts#_ID that this data belongs to.

Constant Value: "raw_contact_id"

RES_PACKAGE

Added in API level 21
public static final 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.

Constant Value: "res_package"

SYNC1

Added in API level 5
public static final String SYNC1

Generic column for use by sync adapters.

Constant Value: "data_sync1"

SYNC2

Added in API level 5
public static final String SYNC2

Generic column for use by sync adapters.

Constant Value: "data_sync2"

SYNC3

Added in API level 5
public static final String SYNC3

Generic column for use by sync adapters.

Constant Value: "data_sync3"

SYNC4

Added in API level 5
public static final String SYNC4

Generic column for use by sync adapters.

Constant Value: "data_sync4"