SimPhonebookContract.SimRecords 類別

定義

命名空間:

Android.Provider

組件:

Mono.Android.dll

SIM 卡上連絡人記錄的常數。

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

[<Android.Runtime.Register("android/provider/SimPhonebookContract$SimRecords", ApiSince=31, DoNotGenerateAcw=true)>]
type SimPhonebookContract.SimRecords = class
    inherit Object

繼承

Object

Object

SimPhonebookContract.SimRecords

屬性

RegisterAttribute

備註

SIM 卡上連絡人記錄的常數。

<h3 id=「simrecords-data」 > Data < /h3>

資料會儲存在特定 SIM 卡上的特定基礎檔案中，而這些檔案彼此隔離。 SIM 卡會以其訂用帳戶識別碼來識別。 SIM 卡可能不支援所有或甚至任何基本檔案類型。 SIM 卡會對每個基礎檔案中可儲存的資料值有條件約束。 您可以使用的 SIM、其支援的基本檔案類型，以及查詢 ElementaryFiles#CONTENT_URI 來探索資料的條件約束。 每個基礎檔案對於可能儲存的記錄數目都有固定容量。 這可以透過資料行的值 ElementaryFiles#MAX_RECORDS 來決定。

資料 SimRecords#PHONE_NUMBER 行只能包含可撥號字元，無論所使用的 SIM 卡為何，都會套用此字元。 如需更多詳細資料，請參閱 android.telephony.PhoneNumberUtils#isDialable(char) \(英文\)。 此外，電話號碼最多可以包含 ElementaryFiles#PHONE_NUMBER_MAX_LENGTH 字元。 當 SimRecords#NAME 資料行編碼為 SIM 卡上的儲存體時，最多可以包含 ElementaryFiles#NAME_MAX_LENGTH 位元組。 編碼是在內部完成，因此名稱應該以 JAVA 字串的形式提供給這些提供者 API，但為儲存體編碼所需的位元組數目會根據包含的字元而有所不同。 這個長度可以藉由呼叫 SimRecords#getEncodedNameLength(ContentResolver, String) 來決定。

<h3 > 作業 < /h3 >< dl >< dd >< b > Insert < /b >< /dd>

僅 ElementaryFiles#EF_ADN 支援插入。 SimRecords#PHONE_NUMBER 是必要資料行。 如果遺漏此資料行所提供的值，將會擲回 null、空白或違反上 IllegalArgumentException 一節所討論的需求。 SimRecords#NAME資料行可能會省略，但如果提供且違反上述資料一節所討論的任何需求， IllegalArgumentException 將會擲回 。

如果無法插入，因為基礎檔案已滿，則會 IllegalStateException 擲回 。

<dd >< b > Update < /b >< /dd>

匯報只能針對 上的 ElementaryFiles#EF_ADN 個別記錄執行。 特定記錄會透過 所 SimRecords#getItemUri(int, int, int) 傳回的 Uri 來參考。 匯報 與 插入具有相同的條件約束和行為 SimRecords#PHONE_NUMBERSimRecords#NAME 。 不過，在更新 SimRecords#PHONE_NUMBER 的情況下，可能會省略 ，因為現有的記錄已經具有有效的值。

<dd >< b > Delete < /b >< /dd>

只能針對 上的 ElementaryFiles#EF_ADN 個別記錄執行刪除。 刪除記錄將會釋出空間供未來插入使用。

<dd >< b > Query < /b >< /dd>

所有儲存在特定基礎檔案上的記錄都可以透過 所 SimRecords#getContentUri(int, int) 傳回的 Uri 讀取。 此查詢一律會傳回所有記錄;不支援透過選取專案進行篩選。 您可以透過 所 SimRecords#getItemUri(int, int, int) 傳回的 Uri 查詢個別記錄。 當具有訂用帳戶識別碼或基礎檔案類型的 SIM 卡無效或無法使用時，查詢會擲 IllegalArgumentException 回 。

</Dl>

的 android.provider.SimPhonebookContract.SimRecords JAVA 檔。

此頁面的部分是根據所建立和共用的工作進行修改，並根據 2.5 屬性授權中所述的詞彙來使用。

欄位

ContentItemType	單一 SIM 記錄CONTENT_URI子目錄的 MIME 類型。
ContentType	CONTENT_URI提供 SIM 記錄目錄的 MIME 類型。
ElementaryFileType	記錄的來源基礎檔案類型。
ErrorNameUnsupported	無法判斷名稱長度時所傳 #getEncodedNameLength(ContentResolver, String) 回的值，因為無法編碼名稱。
Name	此記錄的名稱。
PhoneNumber	此記錄的電話號碼。
RecordNumber	基礎檔案中記錄的以 1 起始的位移，其中包含該記錄。
SubscriptionId	記錄來源之 SIM 卡的訂用帳戶識別碼。

屬性

Class	傳回這個 Object 的執行時間類別。 (繼承來源 Object)
Handle	基礎 Android 實例的控制碼。 (繼承來源 Object)
JniIdentityHashCode	SIM 卡上連絡人記錄的常數。 (繼承來源 Object)
JniPeerMembers	SIM 卡上連絡人記錄的常數。
PeerReference	SIM 卡上連絡人記錄的常數。 (繼承來源 Object)
ThresholdClass	此 API 支援適用于 Android 的 Mono 基礎結構，並不適合直接從您的程式碼使用。 (繼承來源 Object)
ThresholdType	此 API 支援適用于 Android 的 Mono 基礎結構，並不適合直接從您的程式碼使用。 (繼承來源 Object)

方法

Clone()	建立並傳回這個 物件的複本。 (繼承來源 Object)
Dispose()	SIM 卡上連絡人記錄的常數。 (繼承來源 Object)
Dispose(Boolean)	SIM 卡上連絡人記錄的常數。 (繼承來源 Object)
Equals(Object)	指出其他物件是否「等於」這個物件。 (繼承來源 Object)
GetContentUri(Int32, Int32)	傳回指定 SIM 卡上所指定基礎檔案的內容 URI。
GetEncodedNameLength(ContentResolver, String)	傳回儲存在 SIM 卡上時，編碼指定名稱所需的位元組數目。
GetHashCode()	傳回此物件的雜湊碼值。 (繼承來源 Object)
GetItemUri(Int32, Int32, Int32)	具有所提供 #RECORD_NUMBER 之特定 SIM 記錄的內容 URI。
JavaFinalize()	當垃圾收集判斷物件不再參考物件時，垃圾收集行程會在物件上呼叫。 (繼承來源 Object)
Notify()	喚醒正在等候此物件監視器的單一線程。 (繼承來源 Object)
NotifyAll()	喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
ToArray<T>()	SIM 卡上連絡人記錄的常數。 (繼承來源 Object)
ToString()	傳回物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	SIM 卡上連絡人記錄的常數。 (繼承來源 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()	SIM 卡上連絡人記錄的常數。 (繼承來源 Object)
IJavaPeerable.DisposeUnlessReferenced()	SIM 卡上連絡人記錄的常數。 (繼承來源 Object)
IJavaPeerable.Finalized()	SIM 卡上連絡人記錄的常數。 (繼承來源 Object)
IJavaPeerable.JniManagedPeerState	SIM 卡上連絡人記錄的常數。 (繼承來源 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	SIM 卡上連絡人記錄的常數。 (繼承來源 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	SIM 卡上連絡人記錄的常數。 (繼承來源 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	SIM 卡上連絡人記錄的常數。 (繼承來源 Object)

擴充方法

JavaCast<TResult>(IJavaObject)	執行 Android 執行時間檢查的類型轉換。
JavaCast<TResult>(IJavaObject)	SIM 卡上連絡人記錄的常數。
GetJniTypeName(IJavaPeerable)	SIM 卡上連絡人記錄的常數。