ContactsContract.Contacts 类

定义

命名空间:

Android.Provider

程序集:

Mono.Android.dll

联系人表的常量，其中包含每个代表同一个人的原始联系人聚合的记录。

[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

继承

Object

Object

ContactsContract.Contacts

属性

RegisterAttribute

注解

联系人表的常量，其中包含每个代表同一个人的原始联系人聚合的记录。 <h3>Operations</h3><dl><dt><b>Insert</b></dt><dd>无法显式创建联系人。 插入原始联系人时，提供商将首先尝试查找代表同一人的联系人。 如果找到，原始联系人的 RawContacts#CONTACT_ID 列将获取聚合联系人的_ID。 如果未找到匹配项，提供程序会自动插入新的联系人，并将其_ID放入RawContacts#CONTACT_ID新插入的原始联系人的列中。</dd dt b Update/b></dt><dd>仅联系人的某些列可修改：#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。 <如果需要>通过某些数据元素（如电子邮件地址、昵称等）查找联系人，请使用针对表的 ContactsContract.Data 查询。 结果将包含联系人 ID、姓名等。 </ul></dd<>/dl><h2>Columns</h2<>table class=“jd-sumtable”><tr><th colspan='4'Contacts></th<>/tr><td>><long</td><td><#_ID/td><td td>read-only</td><td>行 ID。 请考虑改用 #LOOKUP_KEY 。</td></tr><td><>String</td td<>td>#LOOKUP_KEY</td><td>只读</td td<>>一个不透明的值，其中包含有关如何在由于同步或聚合而更改其行 ID 时如何查找联系人的提示。</td></tr><td>><long</td<>td>NAME_RAW_CONTACT_ID</td<>td>只读</td><td>向聚合联系人提供显示名称的原始联系人的 ID。 在聚合期间，使用启发法选择一个构成原始联系人：选择较长的名称或具有更多音调符号或更多大写字符的名称。</td></tr><td>><String</td<>td>DISPLAY_NAME_PRIMARY</td<>td>只读</td><td>联系人的显示名称。 它是由NAME_RAW_CONTACT_ID列引用的原始联系人贡献的显示名称。</td></tr><tr><td>long</td><td><#PHOTO_ID/td><td>只读</td><td>引用保存照片的表中的ContactsContract.Data行。 该行的 mime 类型 CommonDataKinds.Photo#CONTENT_ITEM_TYPE为 。 此字段的值根据CommonDataKinds.Photo#IS_SUPER_PRIMARY该 mime 类型的数据行的字段自动计算。</td></tr><td>><long</td><td><#PHOTO_URI/td><td td>只读</td><td>可用于检索联系人全尺寸照片的 URI。 此列是检索联系人照片的首选方法。</td></tr><tr><td>long</td><td>#PHOTO_THUMBNAIL_URI</td><td>只读</td><td>A URI，可用于检索联系人照片的缩略图。 此列是检索联系人照片的首选方法。</td></tr><tr><td>int</td td><#IN_VISIBLE_GROUP<>/td><td>只读</td><td>指示此接触是否应在 UI 中可见。 如果联系人至少有一个属于可见组的原始联系人，则为“1”;否则为“0”。</td></tr><tr><td>int</td><td>#HAS_PHONE_NUMBER</td><td>只读</td><td>指示此联系人是否至少有一个电话号码。 如果至少有一个电话号码，则为“1”;否则为“0”。</td/tr><td><td>int</td td>><#STARRED</td<>td>读/写</td td>><收藏联系人的指示器：“1”（如果收藏，则为“0”）。否则为。>< 聚合原始联系人时，会自动计算此字段：如果任何构成的原始联系人被标为星标，则此字段设置为“1”。 设置此字段会自动更改所有构成原始联系人上的相应字段。</td/tr><td<>>字符串</td td><#CUSTOM_RINGTONE<>/td<>td>读/写</td<>td>与联系人关联的自定义铃声。>< 通常，这是通过意向启动的活动返回的 android.media.RingtoneManager#ACTION_RINGTONE_PICKER URI。</td></tr><td><>int</td td><td><#SEND_TO_VOICEMAIL/td<>td>读/写</td td><>指示是否应将此联系人的呼叫直接转发到语音邮件 ('1') ('0') 。 聚合原始联系人时，会自动计算此字段：如果 所有 构成的原始联系人SEND_TO_VOICEMAIL=1，则此字段设置为“1”。 设置此字段会自动更改所有构成原始联系人上的相应字段。</td></tr><tr><td>int</td td><#CONTACT_PRESENCE<>/td><td>只读</td><联系人>IM 状态。 有关单个状态定义，请参阅 StatusUpdates 。 自动计算为所有构成原始接触的最高状态。 提供程序可以选择不将此值存储在永久性存储中。 预期状态将定期更新。</td></tr><td>><字符串</td><td><#CONTACT_STATUS/td><td>只读</td td><>联系人的最新状态更新。 自动计算为所有构成原始联系人状态更新的最新更新。</td/tr><tr><td>long</td td><<>#CONTACT_STATUS_TIMESTAMP/td><td>只读</td><td>插入/更新最新状态时的绝对时间（以毫秒为单位）。<></td></tr><tr><td>String</td><td><#CONTACT_STATUS_RES_PACKAGE/td><td>只读</td><td> 包含此状态的资源的包：标签和图标。</td></tr><td>><long</td td<>td#CONTACT_STATUS_LABEL><<> td>只读</td><td>描述联系人状态来源的标签的资源 ID，例如“Google Talk”。 此资源的范围由 #CONTACT_STATUS_RES_PACKAGE。</td></tr><tr><td>long</td><td td>#CONTACT_STATUS_ICON</td><td>只读</td><td>联系人状态源图标的资源 ID。 此资源的范围由 #CONTACT_STATUS_RES_PACKAGE。</td></tr></table>

的 android.provider.ContactsContract.ContactsJava 文档。

此页面的部分内容是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的术语使用。

构造函数

ContactsContract.Contacts(IntPtr, JniHandleOwnership)

创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。

字段

ContentItemType	单个人的子目录的 #CONTENT_URI MIME 类型。
ContentType	提供人员目录的 #CONTENT_URI MIME 类型。
ContentVcardType	单个人的子目录的 #CONTENT_URI MIME 类型。
ExtraAddressBookIndex	联系人表的常量，其中包含每个代表同一个人的原始联系人聚合的记录。
ExtraAddressBookIndexCounts	联系人表的常量，其中包含每个代表同一个人的原始联系人聚合的记录。
ExtraAddressBookIndexTitles	联系人表的常量，其中包含每个代表同一个人的原始联系人聚合的记录。
QueryParameterVcardNoPhoto	可用于 #CONTENT_VCARD_URI 和 #CONTENT_MULTI_VCARD_URI 的布尔参数，指示返回的 vcard 不应包含照片。

属性

Class	返回此 Object的运行时类。 (继承自 Object)
ContentFilterUri	用于 URI 上的 #CONTENT_URI “类型到筛选器”功能的 content:// 样式 URI。
ContentFrequentUri	用于显示经常联系的人员列表的 content:// 样式 URI。
ContentGroupUri
ContentLookupUri	此表的 content:// 样式 URI，用于创建快捷方式或创建联系人的长期链接。
ContentMultiVcardUri	引用多个Contacts条目的基Uri数，通过追加#LOOKUP_KEY使用 Uri#withAppendedPath(Uri, String)创建。
ContentStrequentFilterUri	用于 URI 上的 #CONTENT_STREQUENT_URI “类型到筛选器”功能的 content:// 样式 URI。
ContentStrequentUri	此表的 content:// 样式 URI 联接了来自 ContactsContract.Data的有用数据，经过筛选，仅包含带星标的联系人。
ContentUri	此表的 content:// 样式 URI
ContentVcardUri	引用单个Contacts条目的基Uri数，通过追加#LOOKUP_KEY使用 Uri#withAppendedPath(Uri, String)创建。
EnterpriseContentFilterUri	它支持与 类似的语义 #CONTENT_FILTER_URI ，并返回相同的列。
EnterpriseContentUri	用于从呼叫用户和链接到该用户的托管配置文件获取所有联系人的 URI。
Handle	基础 Android 实例的句柄。 (继承自 Object)
JniIdentityHashCode	联系人表的常量，其中包含每个代表同一个人的原始联系人聚合的记录。 (继承自 Object)
JniPeerMembers	联系人表的常量，其中包含每个代表同一个人的原始联系人聚合的记录。
PeerReference	联系人表的常量，其中包含每个代表同一个人的原始联系人聚合的记录。 (继承自 Object)
ThresholdClass	此 API 支持 Mono for Android 基础结构，不应直接从代码使用。
ThresholdType	此 API 支持 Mono for Android 基础结构，不应直接从代码使用。

方法

Clone()	创建并返回此对象的副本。 (继承自 Object)
Dispose()	联系人表的常量，其中包含每个代表同一个人的原始联系人聚合的记录。 (继承自 Object)
Dispose(Boolean)	联系人表的常量，其中包含每个代表同一个人的原始联系人聚合的记录。 (继承自 Object)
Equals(Object)	指示其他某个对象是否“等于”此对象。 (继承自 Object)
GetHashCode()	返回对象的哈希代码值。 (继承自 Object)
GetLookupUri(ContentResolver, Uri)	生成描述#CONTENT_LOOKUP_URI所请求条目的Contacts样式Uri。
GetLookupUri(Int64, String)	#CONTENT_LOOKUP_URI使用给定 ContactsContract.Contacts#_ID 的 和 #LOOKUP_KEY生成查找Uri。
IsEnterpriseContactId(Int64)	如果联系人 ID 来自托管配置文件上的联系人提供程序，则返回 true 。
JavaFinalize()	当垃圾回收确定不再引用对象时，由对象上的垃圾回收器调用。 (继承自 Object)
LookupContact(ContentResolver, Uri)	计算内容 URI， (查看 #CONTENT_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> 或 <em>interrupted</em>。<> (继承自 Object)
Wait(Int64)	导致当前线程等待，直到它被唤醒，通常是通过 em <通知/em> 或 <em>interrupted</em>，或直到经过一定数量的实时。<> (继承自 Object)
Wait(Int64, Int32)	导致当前线程等待，直到它被唤醒，通常是通过 em <通知/em> 或 <em>interrupted</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)	联系人表的常量，其中包含每个代表同一个人的原始联系人聚合的记录。