到顶部
Android API
java.lang.Object（java.lang.对象）
   ↳ android.provider。联系人合同。联系人

课程概述

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

操作

插入
无法显式创建联系人。当原始触点插入时，提供程序将首先尝试查找代表同一个人。如果找到一个，原始触点联系人ID列获取聚合的_ID联系人。如果找不到匹配项，提供程序会自动插入一个新的联系并将其_ID放入联系人ID柱新插入的原始触点。
更新
只能修改Contact的某些列：时间_已连接，上次联系时间，已启动，自定义RINGTONE，发送给发票.更改任何Contact上的这些列还更改了所有原始成分联络。
删除
删除联系人时要小心！删除聚合联系人删除所有组成的原始联系人。相应的同步适配器将注意到各自原始联系人的删除并删除它们从后端存储中取出。
查询
  • 如果您需要阅读个人联系人，请考虑使用内容_图书_ URI而不是内容_ URI.
  • 如果您需要通过电话号码查找联系人，请使用电话查找。内容过滤器，为此目的进行了优化。
  • 如果您需要按部分名称查找联系人，例如为了生成过滤你的建议，使用内容过滤器URI。
  • 如果您需要通过电子邮件等数据元素查找联系人地址、昵称等，对联系人合同。数据表。结果将包含联系人ID、姓名等。

柱

联系人
长的 _身份证 只读 行ID。考虑使用LOOKUP_键而不是。
字符串 LOOKUP_键 只读 一个不透明值，包含如何查找联系人的提示行id因同步或聚合而更改。
长的 姓名_原始_联系人_ID 只读 提供显示名称的原始联系人的ID与骨料接触。在聚合过程中，一个组分使用启发式方法选择原始联系人：较长的名称或名称使用更多的变音符号或选择更多的大写字符。
字符串 显示_名称_主要 只读 联系人的显示名称。它是显示名称由NAME_raw_contact_ID引用的原始联系人提供列。
长的 照片_ID 只读 对中的行的引用联系人合同。数据放着照片的桌子。该行具有mime类型目录_ TEM_TYPE。此字段的值根据IS_上游_主要的数据行字段那种哑剧类型。
长的 照片_ URI 只读 可用于检索联系人的全尺寸照片的URI。这个column是检索联系人照片的首选方法。
长的 照片_ HUMBNAIL_URI 只读 一个URI，可用于检索联系人照片的缩略图。这个column是检索联系人照片的首选方法。
整数 IN_VISIBLE_组 只读 该联系人是否应在用户界面。如果联系人至少有一个原始联系人属于可见群体；否则为“0”。
整数 HAS_电话_号码 只读 指示此联系人是否至少有一个电话号码的指示器。如果至少有一个电话号码，则为“1”，否则为“0”。
整数 时间_已连接 读/写 联系联系人的次数。请参阅markAsContacted（内容解析程序，长）。当聚集原始联系人时，此字段为自动计算为所有联系人之间的最大联系次数构成原始触点。设置此字段会自动更改所有组成原始触点上的对应字段。
长的 上次联系时间 读/写 上次联系联系人的时间戳。请参阅markAsContacted（内容解析程序，长）。也会自动设置此字段增量时间_已连接。聚集原始联系人时，此字段自动计算为所有联系人中的最新联系时间构成原始触点。设置此字段会自动更改所有组成原始触点上的对应字段。
整数 已启动 读/写 常用联系人的指示器：如果是常用联系人，则为“1”，否则为“0”。聚集原始联系人时，会自动计算此字段：如果任何组成原始联系人以星号标出，则此字段设置为'1'. 设置此字段会自动更改上的相应字段所有组成原始触点。
字符串 自定义RINGTONE 读/写 与联系人关联的自定义铃声。通常这是使用启动的活动返回的URI动作_灵通_拾音器意图。
整数 发送给发票 读/写 指示是否应转发来自此联系人的呼叫直接发送到语音邮件（'1'）或不发送（'0'）。当原始触点聚合后，此字段将自动计算：如果全部的组成原始联系人的SEND_TO_VOICEMAIL=1，则设置此字段到“1”。设置此字段会自动更改相应的字段在所有组成的原始触点上。
整数 联系人姓名 只读 联系人IM状态。请参阅联系人合同。状态更新针对个人状态定义。自动计算为所有构成原始触点。提供者可以选择不存储此值在持久存储中。预期到场状态将定期更新。
字符串 联系人_状态 只读 联系人的最新状态更新。自动计算为最新所有组成原始联系人的状态更新。
长的 联系人状态时间戳 只读 最新状态为插入/更新。
字符串 联系人状态资源包 只读 包含此状态资源的包：标签和图标。
长的 联系人_状态_标签 只读 描述联系人状态来源的标签的资源ID，例如“谷歌对话”。此资源的范围由联系人状态资源包.
长的 联系人_状态_ICON 只读 联系人状态源图标的资源ID。这个资源的范围由联系人状态资源包.

总结

内部类
班 联系人合同。联络。聚合建议

A类只读单个联系人聚合的子目录包含所有聚合建议（其他联系人）。 
班 联系人合同。联络。数据 包含所有组成原始联系人的单个联系人的子目录联系人合同。数据行。 
班 联系人合同。联络。实体

联系人的子目录，包含其所有联系人合同。原始联系人以及联系人合同。数据行。 
班 联系人合同。联络。照片 A类只读包含以下内容的单个联系人的子目录联系人的主要照片。 
班 联系人合同。联络。StreamItems（流项目）

包含所有组成原始联系人的单个联系人的子目录联系人合同。StreamItems（流项目）行。 
常量
字符串 目录_ TEM_TYPE 的MIME类型内容_ URI单个子目录人。
字符串 内容_类型 的MIME类型内容_ URI提供目录人。
字符串 目录_卡片_类型 的MIME类型内容_ URI单个子目录人。
[展开]
继承的常量
来自接口android.provider。基础列
来自接口android.provider。联系人合同。联系人姓名列
来自接口android.provider。联系人合同。联系人选项列
来自接口android.provider。联系人合同。联系人状态列
来自接口android.provider。联系人合同。联系人栏
领域
公众的静止的最终的乌里 内容过滤器 上用于“type-to-filter”功能的content://样式URI内容_ URIURI。
公众的静止的最终的乌里 内容组
公众的静止的最终的乌里 内容_图书_ URI 应用于创建此表的content://样式URI快捷方式或以其他方式创建联系人的长期链接。
公众的静止的最终的乌里 内容_压力_过滤器_URI 上用于“type-to-filter”功能的content://样式URI内容_趋势_ URIURI。
公众的静止的最终的乌里 内容_趋势_ URI 此表的content://样式URI与来自联系人合同。数据，已筛选为仅包含星号联系人以及最常联系的联系人。
公众的静止的最终的乌里 内容_ URI 此表的content://样式URI
公众的静止的最终的乌里 目录_VCARD_URI 底座乌里用于引用单个联系人条目，通过附加创建LOOKUP_键使用withAppendedPath（Uri，字符串）.
公共方法
静止的乌里 获取查找URI(内容解析器分解器，乌里contactUri）
构建一个内容_图书_ URI风格乌里描述请求联系人条目。
静止的乌里 获取查找URI（长联系人Id，字符串lookupKey）
构建内容_图书_ URI查找乌里使用鉴于_身份证和LOOKUP_键.
静止的乌里 查找联系人(内容解析器分解器，乌里查找URI）
计算内容URI（请参阅内容_ URI)给定了一个查找URI。
静止的空隙 标记为接触(内容解析器解析器，长触点Id）
此方法已弃用API 16级。Android支持库的DataUsageStatUpdater类应该改为使用。
静止的InputStream（输入流） openContactPhotoInputStream(内容解析器铬，乌里contactUri，布尔preferHighres）
打开联系人照片的InputStream并返回照片作为字节流。
静止的InputStream（输入流） openContactPhotoInputStream(内容解析器铬，乌里contactUri）
为联系人的缩略图照片打开InputStream并返回照片作为字节流。
[展开]
继承的方法
来自班级java.lang.Object（java.lang.对象）

常量

公众静态最终的字符串 目录_ TEM_TYPE

已在中添加API级别5

的MIME类型内容_ URI单个子目录人。

常量值： “vnd.android.cursor.item/contact”

公众静态最终的字符串 内容_类型

已在中添加API级别5

的MIME类型内容_ URI提供目录人。

常量值： “vnd.android.cursor.dir/contact”

公众静态最终的字符串 目录_卡片_类型

已在中添加API级别5

的MIME类型内容_ URI单个子目录人。

常量值： “文本/x-vcard”

领域

公众静态最终的乌里 内容过滤器

已在中添加API级别5

上用于“type-to-filter”功能的content://样式URI内容_ URIURI。过滤器字符串将用于匹配联系人姓名的各个部分。应传递筛选器参数作为该URI之后的附加路径段。

公众静态最终的乌里 内容组

已在中添加API级别5

公众静态最终的乌里 内容_图书_ URI

已在中添加API级别5

应用于创建此表的content://样式URI快捷方式或以其他方式创建到联系人的长期链接。此URI应始终后跟“/”和联系人的LOOKUP_键.它还可以选择在后面附加一个“/”和最后一个已知联系人ID那个。这种“完整”格式是一种重要的优化，强烈建议使用。

只要联系人的行ID保持不变，这个URI就是相当于内容_ URI。如果联系人的行ID更改作为同步或聚合的结果，此URI将查找使用间接信息联系（同步ID或原始成分触点）。

查找键应在未编码的情况下追加-它存储在编码的表单，可以在URI中使用。

公众静态最终的乌里 内容_压力_过滤器_URI

已在中添加API级别5

上用于“type-to-filter”功能的content://样式URI内容_趋势_ URIURI。过滤器字符串将用于匹配联系人姓名的各个部分。应传递筛选器参数作为此URI之后的附加路径段。

公众静态最终的乌里 内容_趋势_ URI

已在中添加API级别5

此表的content://样式URI与来自联系人合同。数据，已筛选为仅包含星号联系人以及最常联系的联系人。

公众静态最终的乌里 内容_ URI

已在中添加API级别5

此表的content://样式URI

公众静态最终的乌里 目录_VCARD_URI

已在中添加API级别5

底座乌里用于引用单个联系人条目，通过附加创建LOOKUP_键使用withAppendedPath（Uri，字符串）。提供可打开的列列，或返回通过打开时格式化为vCard的引用联系人openAssetFileDescriptor（Uri，字符串）.

公共方法

公众静止的乌里 获取查找URI (内容解析器分解器，乌里contactUri）

已在中添加API级别5

构建一个内容_图书_ URI风格乌里描述请求联系人条目。

参数
contactUri（联系人URI） A类内容_ URI行，或现有的内容_图书_ URI尝试刷新。

公众静止的乌里 获取查找URI （长联系人Id，字符串lookupKey）

已在中添加API级别5

构建内容_图书_ URI查找乌里使用鉴于_身份证和LOOKUP_键.

公众静止的乌里 查找联系人 (内容解析器分解器，乌里查找URI）

已在中添加API级别5

计算内容URI（请参阅内容_ URI)给定了一个查找URI。

如果找不到联系人，则返回null。

公众静态空隙 标记为接触 (内容解析器解析器，长触点Id）

已在中添加API级别5

此方法已弃用API 16级。
Android支持库的DataUsageStatUpdater类应该改为使用。

将联系人标记为已联系。更新两个字段：时间_已连接和上次联系时间. TheTIMES_CONTACTED字段递增1，LAST_TIME_CONTACTED字段中填充了当前系统时间。

参数
分解器 要使用的ContentResolver
联系人ID 被联系的人

公众静止的InputStream（输入流） openContactPhotoInputStream (内容解析器铬，乌里contactUri，布尔preferHighres）

已在中添加API级别14

打开联系人照片的InputStream并返回照片作为字节流。

参数
铬 用于查询的内容解析器
contactUri（联系人URI） 应该使用照片的联系人。这可以与一起使用要么是a内容_ URI或a内容_图书_ URIURI。
首选高分辨率 如果这是真的，并且联系人的照片分辨率更高可用，则返回。如果为false，此函数将始终尝试获取缩略图
退换商品
  • 照片的InputStream，如果没有照片，则为null

公众静止的InputStream（输入流） openContactPhotoInputStream (内容解析器cr，乌里contactUri）

已在中添加API级别5

为联系人的缩略图照片打开InputStream并返回照片作为字节流。

参数
铬 用于查询的内容解析器
联系人Uri 应该使用照片的联系人。这可以与一起使用要么是a内容_ URI或a内容_图书_ URIURI。
退换商品
  • 照片的InputStream，如果没有照片，则为null
另请参见