ContactsContract.Contacts 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
連絡人資料表的常數,其中包含代表相同人員之原始連絡人之每個匯總的記錄。
[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 > 連絡人的特定資料行是可修改的: #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 td/td >><<#_ID
><> td 唯讀 < /td >< 資料 > 列識別碼。 < 請考慮改用 #LOOKUP_KEY
。 </td/tr > td ><>>< String < /td <> td/td td #LOOKUP_KEY
>< 唯讀 < /td ><> td ><> 不透明值,其中包含如何在其資料列識別碼因同步或匯總而變更時如何尋找連絡人的提示。 <</td/tr > td >>><< long < /td td ><> NAME_RAW_CONTACT_ID < /td td ><> 唯讀 < /td td >>< 原始連絡人的識別碼,該連絡人會將顯示名稱提供給匯總連絡人。 < 在匯總期間,會使用啟發學習法選擇其中一個構成原始連絡人:選擇較長的名稱或具有更多讀音符號或更多大寫字元的名稱。 </td/tr ><<> td <>> String < /td td <>> DISPLAY_NAME_PRIMARY < /td td ><<> 唯讀/td td >< 連絡人 > 的顯示名稱。 這是由NAME_RAW_CONTACT_ID資料行所參考之原始連絡人所參與的顯示名稱。 </td/tr >< tr >< td ><> long < /td >< td td <>#PHOTO_ID
唯讀/td <><> td > td >< 保存相片之表格中資料列的 ContactsContract.Data
參考。 該資料列具有 mime 類型 CommonDataKinds.Photo#CONTENT_ITEM_TYPE
。 此欄位的值會根據 CommonDataKinds.Photo#IS_SUPER_PRIMARY
該 mime 類型之資料列的資料欄欄位自動計算。 </td/tr ><>< td <>> long < /td <> td td <>#PHOTO_URI
唯讀/td ><>< td ><> URI,可用來擷取連絡人的完整相片。 此欄是擷取連絡人相片的慣用方法。 </td/tr > td <<>>> long < /td >< td td ><> td >#PHOTO_THUMBNAIL_URI
< 唯讀 < /td Td >>< URI,可用來擷取連絡人相片的縮圖。 < 此欄是擷取連絡人相片的慣用方法。 </td/tr tr ><<> td >>< int < /td >< td td >#IN_VISIBLE_GROUP
< 唯讀 < /td ><> td td ><> 指出此連絡人是否應該顯示在 UI 中。 如果連絡人至少有一個屬於可見群組的原始連絡人,則為 「1」。否則為 「0」。 </td/tr >< tr >< td >>< int < /td >< td ><#HAS_PHONE_NUMBER
/td >>< td 唯讀 < /td td ><> 指出此連絡人是否至少有一個電話號碼。 如果至少有一個電話號碼,則為 「1」,否則為 「0」。 </td/tr tr ><>< td >>< int < /td >< td/td td ><#STARRED
><> read/write < /td td >>< 我的最愛連絡人指標:'1',否則為 '0'。 匯總原始連絡人時,會自動計算此欄位:如果有任何構成原始連絡人已星號,則此欄位會設定為 '1'。 設定此欄位會自動變更所有構成原始連絡人上的對應欄位。 </td/tr tr ><>< td >>< String < /td >< td/td td ><#CUSTOM_RINGTONE
><> read/write < /td ><> 與連絡人相關聯的自訂環形。 一般而言,這是以意圖啟動的活動所傳回的 android.media.RingtoneManager#ACTION_RINGTONE_PICKER
URI。 </td >< /tr tr >><< td > int < /td >< td/td td ><#SEND_TO_VOICEMAIL
><> read/write < /td td >>< 指出此連絡人的通話是否應該直接轉送到語音信箱 ('1') ,或未 ('0') 。 匯總原始連絡人時,會自動計算此欄位:如果 所有 構成的原始連絡人都SEND_TO_VOICEMAIL=1,則此欄位會設定為 '1'。 設定此欄位會自動變更所有構成原始連絡人上的對應欄位。 </td/tr tr ><>< td ><> int < /td >< td >#CONTACT_PRESENCE
< /td td ><> 唯讀 < /td td >< 連絡人 > IM 狀態。 如需個別狀態定義,請參閱 StatusUpdates
。 自動計算為所有構成原始連絡人的最高存在狀態。 提供者可以選擇不要將此值儲存在永續性儲存體中。 預期會定期更新目前狀態。 </td/tr tr >><< td >>< String < /td >< td/td #CONTACT_STATUS
>< td ><> 唯讀 < /td td ><> 連絡人的最新狀態更新。 自動計算為所有構成原始連絡人狀態更新的最新版本。 </td/tr ><<> td ><> long < /td >< td td <#CONTACT_STATUS_TIMESTAMP
> 唯讀 < /td ><> td <>> 插入/更新最新狀態時,以毫秒為單位的絕對時間。 </td/tr ><<> td ><> String < /td <> td/td td <#CONTACT_STATUS_RES_PACKAGE
> 唯讀 < /td ><> td <>> 包含此狀態資源的套件:標籤和圖示。 </td/tr ><<> td >>< long < /td <> td/td td <#CONTACT_STATUS_LABEL
> 唯讀 < /td >>< td ><> 描述連絡人狀態來源的標籤資源識別碼,例如「Google Talk」。 此資源的範圍由 #CONTACT_STATUS_RES_PACKAGE
。 </td/tr ><>< td <>> long < /td <> td td <>#CONTACT_STATUS_ICON
唯讀/td ><>< td ><> 連絡人狀態來源圖示的資源識別碼。 此資源的範圍由 #CONTACT_STATUS_RES_PACKAGE
。 </td >< /tr >< /table>
的 android.provider.ContactsContract.Contacts
JAVA 檔。
此頁面的部分是根據 原始碼專案所建立和共用的工作進行修改,並根據中所述的詞彙使用。
建構函式
ContactsContract.Contacts(IntPtr, JniHandleOwnership) |
建立 JNI 物件的 Managed 標記法時所使用的建構函式;由執行時間呼叫。 |
欄位
ContentItemType |
單一 |
ContentType |
提供人員目錄的 MIME 類型 |
ContentVcardType |
單一 |
ExtraAddressBookIndex |
連絡人資料表的常數,其中包含代表相同人員之原始連絡人之每個匯總的記錄。 |
ExtraAddressBookIndexCounts |
連絡人資料表的常數,其中包含代表相同人員之原始連絡人之每個匯總的記錄。 |
ExtraAddressBookIndexTitles |
連絡人資料表的常數,其中包含代表相同人員之原始連絡人之每個匯總的記錄。 |
QueryParameterVcardNoPhoto |
可搭配 |
屬性
Class |
傳回這個 |
ContentFilterUri |
用於 URI 上 |
ContentFrequentUri |
用來顯示經常連絡人員清單的 content:// 樣式 URI。 |
ContentGroupUri | |
ContentLookupUri |
此資料表的 content:// 樣式 URI,應該用來建立快捷方式,或建立連絡人的長期連結。 |
ContentMultiVcardUri |
參考多個 |
ContentStrequentFilterUri |
用於 URI 上 |
ContentStrequentUri |
此資料表的 content:// 樣式 URI,已與 中 |
ContentUri |
此資料表的 content:// 樣式 URI |
ContentVcardUri |
參考單 |
EnterpriseContentFilterUri |
它支援與 類似的語意 |
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) |
建置 |
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 > notified < /em > 或 < em > interrupted < /em > 來喚醒。 (繼承來源 Object) |
Wait(Int64) |
讓目前的執行緒等到喚醒為止,通常是 < 透過 em > notified < /em 或 em > interrupted < /em >> ,或 < 直到經過一定數量的即時為止。 (繼承來源 Object) |
Wait(Int64, Int32) |
讓目前的執行緒等到喚醒為止,通常是 < 透過 em > notified < /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) |
連絡人資料表的常數,其中包含代表相同人員之原始連絡人之每個匯總的記錄。 |