ContactsContract.DataUsageFeedback 類別

定義

[Android.Runtime.Register("android/provider/ContactsContract$DataUsageFeedback", DoNotGenerateAcw=true)]
public sealed class ContactsContract.DataUsageFeedback : Java.Lang.Object

[<Android.Runtime.Register("android/provider/ContactsContract$DataUsageFeedback", DoNotGenerateAcw=true)>]
type ContactsContract.DataUsageFeedback = class
    inherit Object

繼承

Object

Object

ContactsContract.DataUsageFeedback

屬性

RegisterAttribute

備註

允許應用程式將每個 Data 數據列的使用方式資訊傳送給聯繫人提供者的 API。 應用程式也可以清除所有使用方式資訊。

<p class=“caution”><b>注意： </b>如果您將您的應用程式發佈到 Google Play Store，則不論 Android 版本為何，此字段已過時。 如需詳細資訊，請參閱聯繫人提供者頁面。</P>

透過意見反應，聯繫人提供者可能會針對數據清單傳回更內容適當的結果，通常由 ContactsContract.Contacts#CONTENT_FILTER_URI、 ContactsContract.CommonDataKinds.Email#CONTENT_FILTER_URI、 ContactsContract.CommonDataKinds.Phone#CONTENT_FILTER_URI和使用者提供，可受益於顯示自動完成清單之應用程式中排名較佳的（已排序）清單。

不保證使用此意見反應的方式，或是否完全使用它。 排名演算法會盡最大努力使用意見反應數據，但確切的實作、記憶體數據結構以及產生的排序順序是裝置和版本特定，而且可能會隨著時間而變更。

更新使用方式資訊時，此 API 的用戶必須搭配建構自 DataUsageFeedback#FEEDBACK_URI的 Uri 使用ContentResolver#update(Uri, ContentValues, String, String[])。 URI 必須包含一或多個數據標識碼作為其最後一個路徑。 它們也需要將查詢參數附加至 Uri，以指定通訊的類型，這可讓聯繫人提供者使用相同的聯繫人數據欄位來區分互動類型（例如，電話號碼可用來撥打電話或傳送簡訊）。

選取範圍和 selectionArgs 會被忽略，而且必須設定為 null。 若要取得資料識別碼，您可能需要呼叫 ContentResolver#query(Uri, String[], String, String[], String) 。Data#CONTENT_URI

ContentResolver#update(Uri, ContentValues, String, String[]) 成功時會傳回正整數，如果找不到該標識符的連絡，則傳回 0。

範例：

Uri uri = DataUsageFeedback.FEEDBACK_URI.buildUpon()
                    .appendPath(TextUtils.join(",", dataIds))
                    .appendQueryParameter(DataUsageFeedback.USAGE_TYPE,
                            DataUsageFeedback.USAGE_TYPE_CALL)
                    .build();
            boolean successful = resolver.update(uri, new ContentValues(), null, null) > 0;

</p>

應用程式也可以使用下列方式清除所有使用資訊：

boolean successful = resolver.delete(DataUsageFeedback.DELETE_USAGE_URI, null, null) > 0;

</p>

已取代這個成員。 自Android版本 android.os.Build.VERSION_CODES#Q起，不再支持聯繫人親和性資訊。 一律會忽略更新和刪除呼叫。

的 android.provider.ContactsContract.DataUsageFeedbackJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

建構函式

欄位

屬性

方法

明確介面實作

擴充方法

適用於