SimPhonebookContract.SimRecords クラス

定義

[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

JavaObject

Object

SimPhonebookContract.SimRecords

属性

RegisterAttribute

注釈

SIM カードの連絡先レコードの定数。

<h3 id="simrecords-data">Data</h3>

データは特定の SIM カード上の特定の基本ファイルに格納され、相互に分離されます。 SIM カードは、サブスクリプション ID によって識別されます。 SIM カードは、基本ファイルの種類のすべてまたはいずれかをサポートしていない場合があります。 SIM には、各基本ファイルに格納できるデータの値に制約があります。 使用可能な SID、サポートされている基本ファイルの種類、およびデータに対する制約は、 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>Operations </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_NUMBER と SimRecords#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 を使用してクエリを実行できます。 サブスクリプション ID または基本ファイルの種類を持つ SIM が無効または使用できない場合、クエリは IllegalArgumentException をスローします。

</dl>

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。