ContactsContract.Contacts Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Константы для таблицы контактов, которая содержит запись для каждого агрегата необработанных контактов, представляющих одного человека.
[Android.Runtime.Register("android/provider/ContactsContract$Contacts", DoNotGenerateAcw=true)]
public class ContactsContract.Contacts : Java.Lang.Object
[<Android.Runtime.Register("android/provider/ContactsContract$Contacts", DoNotGenerateAcw=true)>]
type ContactsContract.Contacts = class
inherit Object
- Наследование
- Атрибуты
Комментарии
Константы для таблицы контактов, которая содержит запись для каждого агрегата необработанных контактов, представляющих одного человека. <h3>Operations</h3><dl><dt><b>Insert</b></dt><dd>A Contact невозможно создать явным образом. При вставке необработанного контакта поставщик сначала попытается найти контакт, представляющий того же человека. Если он найден, столбец необработанного контакта RawContacts#CONTACT_ID
получает _ID агрегатного контакта. Если совпадения не найдены, поставщик автоматически вставляет новый контакт и помещает его _ID в RawContacts#CONTACT_ID
столбец вновь вставленного необработанного контакта.</dd><dt><b>Update</b></dt><dd>Только некоторые столбцы Contact могут изменяться: #STARRED
, #CUSTOM_RINGTONE
, #SEND_TO_VOICEMAIL
. Изменение любого из этих столбцов в контакте также изменяет их для всех составляющих необработанных контактов.</dd><dt><b>Delete</b></dt><dd>Будьте осторожны с удалением контактов! При удалении агрегатного контакта удаляются все составляющие необработанные контакты. Соответствующие адаптеры синхронизации замечают удаление соответствующих необработанных контактов и удаляют их из внутреннего хранилища.</dd><dt><b>Query</b></dt><dd><ul><li>Если вам нужно прочитать отдельный контакт, рассмотрите возможность использования #CONTENT_LOOKUP_URI
вместо #CONTENT_URI
.</li><li>. Если вам нужно найти контакт по номеру телефона, используйте PhoneLookup#CONTENT_FILTER_URI PhoneLookup.CONTENT_FILTER_URI
, который оптимизирован для этой цели.</li><li>. Если требуется найти контакт по частичному имени, например для создания предложений фильтра по мере использования, используйте универсальный #CONTENT_FILTER_URI
код ресурса (URI). <Li>Если вам нужно найти контакт по некоторым элементам данных, таким как адрес электронной почты, псевдоним и т. д., используйте запрос к ContactsContract.Data
таблице. Результат будет содержать идентификатор контакта, имя и т. д. </ul></dd></dl><h2>Columns</h2><table class="jd-sumtable"<>tr<>th colspan='4'Contacts<>/th></tr tr><><td>long</td<>td<>#_ID
/td td<>td>только< для чтения/td td><>идентификатор строки. Вместо этого рекомендуется использовать #LOOKUP_KEY
.</td></tr<>td<>>String</td<>td>#LOOKUP_KEY
</td><td td>только< для чтения/td td<>td>Непрозрачное значение, содержащее подсказки о том, как найти контакт, если его идентификатор строки изменился в результате синхронизации или агрегирования.</td></tr><td><>long</td<>td>NAME_RAW_CONTACT_ID</td<>td td>только< для чтения/td td><>— идентификатор необработанного контакта, который вносит отображаемое имя в агрегатный контакт. Во время агрегирования один из составляющих необработанных контактов выбирается с использованием эвристического: выбирается более длинное имя или имя с более диакритичными знаками или более прописными буквами.</td></tr<<>>td>String</td<>td>DISPLAY_NAME_PRIMARY</td><td td>только< для чтения/td td><td>Отображаемое имя контакта. Это отображаемое имя, предоставленное необработанным контактом, на который ссылается столбец NAME_RAW_CONTACT_ID.</td></tr<>tr<>td>long</td><td<>#PHOTO_ID
/td><td td>только< для чтения/td td>><ссылка на строку в таблице, включающей ContactsContract.Data
фотографию. Эта строка имеет тип CommonDataKinds.Photo#CONTENT_ITEM_TYPE
mime . Значение этого поля вычисляется автоматически на CommonDataKinds.Photo#IS_SUPER_PRIMARY
основе поля строк данных этого типа mime.</td></tr><td><>long</td<>td#PHOTO_URI
></td<>td td>только< для чтения/td td><>A URI, который можно использовать для получения полноразмерной фотографии контакта. Этот столбец является предпочтительным методом получения фотографии контакта.</td></tr><td><>long</td<>td#PHOTO_THUMBNAIL_URI
></td<>td td>только< для чтения/td td><>A URI, который можно использовать для получения эскиза фотографии контакта. Этот столбец является предпочтительным методом получения фотографии контакта.</td></tr<><>td>int</td<>td<>#IN_VISIBLE_GROUP
/td><td td td>только< для чтения/td><td>— индикатор того, должен ли этот контакт быть видимым в пользовательском интерфейсе. "1", если у контакта есть хотя бы один необработанный контакт, принадлежащий к видимой группе; "0" в противном случае.</td></tr<><>td>int</td<>td<>#HAS_PHONE_NUMBER
/td><td td>только< для чтения/td><td>— индикатор наличия у этого контакта хотя бы одного номера телефона. "1", если имеется хотя бы один номер телефона, "0" в противном случае.</td></tr><td<>>int</td<>td#STARRED
></td><td td>read/write</td><td>Индикатор для избранных контактов: "1", если избранное, "0" в противном случае. При агрегации необработанных контактов это поле вычисляется автоматически: если отображаются какие-либо составляющие необработанные контакты, то для этого поля устанавливается значение "1". Установка этого поля автоматически изменяет соответствующее поле для всех составляющих необработанных контактов.</td></tr<><>td>String</td<>td<>#CUSTOM_RINGTONE
/td><td td>read/write</td><td td>— настраиваемый мелодия звонка, связанная с контактом. Обычно это универсальный код ресурса (URI), возвращаемый действием, запущенным с намерением android.media.RingtoneManager#ACTION_RINGTONE_PICKER
.</td></tr<><>td>int</td<>td<>#SEND_TO_VOICEMAIL
/td><td td>read/write</td><td td>— индикатор того, следует ли переадресовывать звонки от этого контакта непосредственно в голосовую почту ('1') или нет ('0'). При агрегации необработанных контактов это поле вычисляется автоматически: если все составляющие необработанные контакты имеют SEND_TO_VOICEMAIL=1, то этому полю присваивается значение "1". Установка этого поля автоматически изменяет соответствующее поле для всех составляющих необработанных контактов.</td></tr<>><td>int</td><td><#CONTACT_PRESENCE
/td><td td>только< для чтения/td td><td>Состояние присутствия мгновенных сообщений контакта. Сведения об отдельных определениях состояния см StatusUpdates
. в разделе. Автоматически вычисляется как максимальное присутствие всех составляющих необработанных контактов. Поставщик может не хранить это значение в постоянном хранилище. Ожидается, что состояние присутствия будет регулярно обновляться.</td></tr<>><td>String</td><td><#CONTACT_STATUS
/td><td td td>только< для чтения/td td><>последнее обновление состояния контакта. Автоматически вычисляется как последнее из всех составляющих необработанных обновлений состояния контактов.</td></tr<>tr<>td>long</td><td<>#CONTACT_STATUS_TIMESTAMP
/td><td td>только< для чтения/td td>><— абсолютное время в миллисекундах, когда было вставлено или обновлено последнее состояние.</td></tr<>td<>>String</td<>td>#CONTACT_STATUS_RES_PACKAGE
</td><td td td>только< для чтения/td td<>> Пакет, содержащий ресурсы для этого состояния: метка и значок.</td></tr><td><>long</td<>td#CONTACT_STATUS_LABEL
></td<>td td>только< для чтения/td td><>— идентификатор ресурса метки, описывающей источник состояния контакта, например "Google Talk". Область действия этого ресурса определяется #CONTACT_STATUS_RES_PACKAGE
.</td></tr><td><>long</td<>td#CONTACT_STATUS_ICON
></td<>td td>только< для чтения/td td><>— идентификатор ресурса значка для источника состояния контакта. Область действия этого ресурса определяется #CONTACT_STATUS_RES_PACKAGE
.</td></tr></table>
Документация по Java для android.provider.ContactsContract.Contacts
.
Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License Creative Commons 2.5 Attribution License.
Конструкторы
ContactsContract.Contacts(IntPtr, JniHandleOwnership) |
Конструктор, используемый при создании управляемых представлений объектов JNI; вызывается средой выполнения. |
Поля
ContentItemType |
Тип MIME подкаталога |
ContentType |
Тип MIME для |
ContentVcardType |
Тип MIME подкаталога |
ExtraAddressBookIndex |
Константы для таблицы контактов, которая содержит запись для каждого агрегата необработанных контактов, представляющих одного человека. |
ExtraAddressBookIndexCounts |
Константы для таблицы контактов, которая содержит запись для каждого агрегата необработанных контактов, представляющих одного человека. |
ExtraAddressBookIndexTitles |
Константы для таблицы контактов, которая содержит запись для каждого агрегата необработанных контактов, представляющих одного человека. |
QueryParameterVcardNoPhoto |
Логический параметр, который можно использовать с |
Свойства
Class |
Возвращает класс среды выполнения данного объекта |
ContentFilterUri |
Универсальный код ресурса (URI) стиля content://, используемый для функции "тип — фильтр" в |
ContentFrequentUri |
Универсальный код ресурса (URI) стиля content:// для отображения списка часто используемых пользователей. |
ContentGroupUri | |
ContentLookupUri |
Универсальный код ресурса (URI) content:// стиле для этой таблицы, который следует использовать для создания ярлыков или создания долгосрочных ссылок на контакты. |
ContentMultiVcardUri |
База |
ContentStrequentFilterUri |
Универсальный код ресурса (URI) стиля content://, используемый для функции "тип — фильтр" в |
ContentStrequentUri |
Универсальный код ресурса (URI) стиля content:// для этой таблицы, объединенный с полезными данными из |
ContentUri |
URI стиля content:// для этой таблицы |
ContentVcardUri |
База |
EnterpriseContentFilterUri |
Он поддерживает аналогичную семантику и |
EnterpriseContentUri |
URI, используемый для получения всех контактов как от вызывающего пользователя, так и от связанного с ним управляемого профиля. |
Handle |
Дескриптор базового экземпляра Android. (Унаследовано от Object) |
JniIdentityHashCode |
Константы для таблицы контактов, которая содержит запись для каждого агрегата необработанных контактов, представляющих одного человека. (Унаследовано от Object) |
JniPeerMembers |
Константы для таблицы контактов, которая содержит запись для каждого агрегата необработанных контактов, представляющих одного человека. |
PeerReference |
Константы для таблицы контактов, которая содержит запись для каждого агрегата необработанных контактов, представляющих одного человека. (Унаследовано от Object) |
ThresholdClass |
Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. |
ThresholdType |
Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. |
Методы
Clone() |
Создает и возвращает копию этого объекта. (Унаследовано от Object) |
Dispose() |
Константы для таблицы контактов, которая содержит запись для каждого агрегата необработанных контактов, представляющих одного человека. (Унаследовано от Object) |
Dispose(Boolean) |
Константы для таблицы контактов, которая содержит запись для каждого агрегата необработанных контактов, представляющих одного человека. (Унаследовано от Object) |
Equals(Object) |
Указывает, равен ли какой-то другой объект этому объекту. (Унаследовано от Object) |
GetHashCode() |
Возвращает значение хэш-кода для объекта. (Унаследовано от Object) |
GetLookupUri(ContentResolver, Uri) |
Создает стиль |
GetLookupUri(Int64, String) |
Создайте подстановку |
IsEnterpriseContactId(Int64) |
Возвращает значение |
JavaFinalize() |
Вызывается сборщиком мусора для объекта , когда сборка мусора определяет, что больше нет ссылок на объект . (Унаследовано от Object) |
LookupContact(ContentResolver, Uri) |
Вычисляет URI содержимого (см. |
MarkAsContacted(ContentResolver, Int64) |
Устаревшие..
Пометьте контакт как с ним контакт. |
Notify() |
Пробуждение одного потока, ожидающего на мониторе этого объекта. (Унаследовано от Object) |
NotifyAll() |
Активирует все потоки, ожидающие на мониторе этого объекта. (Унаследовано от Object) |
OpenContactPhotoInputStream(ContentResolver, Uri) |
Открывает объект InputStream для эскиза фотографии контактов и возвращает фотографию в виде потока байтов. |
OpenContactPhotoInputStream(ContentResolver, Uri, Boolean) |
Открывает InputStream для фотографии контактов и возвращает фотографию в виде потока байтов. |
SetHandle(IntPtr, JniHandleOwnership) |
Задает свойство Handle. (Унаследовано от Object) |
ToArray<T>() |
Константы для таблицы контактов, которая содержит запись для каждого агрегата необработанных контактов, представляющих одного человека. (Унаследовано от Object) |
ToString() |
Возвращает строковое представление объекта. (Унаследовано от Object) |
UnregisterFromRuntime() |
Константы для таблицы контактов, которая содержит запись для каждого агрегата необработанных контактов, представляющих одного человека. (Унаследовано от Object) |
Wait() |
Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления/><em> или <прерывания></em>. (Унаследовано от Object) |
Wait(Int64) |
Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления</>em>, <>прерывания< или> em, либо до истечения определенного количества реального времени. (Унаследовано от Object) |
Wait(Int64, Int32) |
Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления</>em>, <>прерывания< или> em, либо до истечения определенного количества реального времени. (Унаследовано от Object) |
Явные реализации интерфейса
IJavaPeerable.Disposed() |
Константы для таблицы контактов, которая содержит запись для каждого агрегата необработанных контактов, представляющих одного человека. (Унаследовано от Object) |
IJavaPeerable.DisposeUnlessReferenced() |
Константы для таблицы контактов, которая содержит запись для каждого агрегата необработанных контактов, представляющих одного человека. (Унаследовано от Object) |
IJavaPeerable.Finalized() |
Константы для таблицы контактов, которая содержит запись для каждого агрегата необработанных контактов, представляющих одного человека. (Унаследовано от Object) |
IJavaPeerable.JniManagedPeerState |
Константы для таблицы контактов, которая содержит запись для каждого агрегата необработанных контактов, представляющих одного человека. (Унаследовано от Object) |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
Константы для таблицы контактов, которая содержит запись для каждого агрегата необработанных контактов, представляющих одного человека. (Унаследовано от Object) |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Константы для таблицы контактов, которая содержит запись для каждого агрегата необработанных контактов, представляющих одного человека. (Унаследовано от Object) |
IJavaPeerable.SetPeerReference(JniObjectReference) |
Константы для таблицы контактов, которая содержит запись для каждого агрегата необработанных контактов, представляющих одного человека. (Унаследовано от Object) |
Методы расширения
JavaCast<TResult>(IJavaObject) |
Выполняет преобразование типа, проверенное средой выполнения Android. |
JavaCast<TResult>(IJavaObject) |
Константы для таблицы контактов, которая содержит запись для каждого агрегата необработанных контактов, представляющих одного человека. |
GetJniTypeName(IJavaPeerable) |
Константы для таблицы контактов, которая содержит запись для каждого агрегата необработанных контактов, представляющих одного человека. |