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 卡由其订阅 ID 标识。 SIM 卡可能不支持所有甚至任何基本文件类型。 SIM 将对可存储在每个基本文件中的数据值具有约束。 可以通过查询 ElementaryFiles#CONTENT_URI来发现可用的 SIM、它们支持的基本文件类型和数据约束。 每个基本文件对于可存储的记录数具有固定容量。 这可以从列的值 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单个记录执行汇报。 特定记录通过 返回的 URI 进行 SimRecords#getItemUri(int, int, int)引用。 汇报 与 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>

的 android.provider.SimPhonebookContract.SimRecordsJava 文档。

此页面的部分内容是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的术语使用。

字段

ContentItemType	单个 SIM 记录CONTENT_URI子目录的 MIME 类型。
ContentType	MIME 类型的CONTENT_URI提供 SIM 记录目录。
ElementaryFileType	记录所来自的基本文件的类型。
ErrorNameUnsupported	由于无法对名称进行编码而无法确定名称长度时返回 #getEncodedNameLength(ContentResolver, String) 的值。
Name	此记录的名称。
PhoneNumber	此记录的电话号码。
RecordNumber	包含记录的基本文件中记录的从 1 开始的偏移量。
SubscriptionId	记录来自的 SIM 卡的订阅 ID。

属性

Class	返回此 Object的运行时类。 (继承自 Object)
Handle	基础 Android 实例的句柄。 (继承自 Object)
JniIdentityHashCode	SIM 卡上的联系人记录的常量。 (继承自 Object)
JniPeerMembers	SIM 卡上的联系人记录的常量。
PeerReference	SIM 卡上的联系人记录的常量。 (继承自 Object)
ThresholdClass	此 API 支持 Mono for Android 基础结构，不应直接从代码使用。 (继承自 Object)
ThresholdType	此 API 支持 Mono for Android 基础结构，不应直接从代码使用。 (继承自 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 <通知/em> 或 <em>interrupted</em>。<> (继承自 Object)
Wait(Int64)	导致当前线程等待，直到它被唤醒，通常是通过 em <通知/em> 或 <em>interrupted</em>，或直到经过一定数量的实时。<> (继承自 Object)
Wait(Int64, Int32)	导致当前线程等待，直到它被唤醒，通常是通过 em <通知/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 卡上的联系人记录的常量。