SimPhonebookContract.SimRecords Clase

Definición

[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

Herencia

Object

JavaObject

Object

SimPhonebookContract.SimRecords

Atributos

RegisterAttribute

Comentarios

Constantes para los registros de contacto en una tarjeta SIM.

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

Los datos se almacenan en un archivo elemental específico en una tarjeta SIM específica y se aíslan entre sí. Las tarjetas SIM se identifican mediante su identificador de suscripción. Es posible que las tarjetas SIM no admitan todos o incluso ninguno de los tipos de archivo elementales. Una SIM tendrá restricciones en los valores de los datos que se pueden almacenar en cada archivo elemental. Los SIM disponibles, sus tipos de archivo elementales admitidos y las restricciones de los datos se pueden detectar consultando ElementaryFiles#CONTENT_URI. Cada archivo elemental tiene una capacidad fija para el número de registros que se pueden almacenar. Esto se puede determinar a partir del valor de la ElementaryFiles#MAX_RECORDS columna.

La SimRecords#PHONE_NUMBER columna solo puede contener caracteres marcados y esto se aplica independientemente de la SIM que se use. Consulte android.telephony.PhoneNumberUtils#isDialable(char) para obtener más detalles. Además, el número de teléfono puede contener como máximo ElementaryFiles#PHONE_NUMBER_MAX_LENGTH caracteres. La SimRecords#NAME columna puede contener como máximo ElementaryFiles#NAME_MAX_LENGTH bytes cuando se codifica para el almacenamiento en la SIM. La codificación se realiza internamente y, por tanto, el nombre debe proporcionarse a estas API de proveedor como una cadena de Java, pero el número de bytes necesarios para codificarlo para el almacenamiento variará en función de los caracteres que contiene. Esta longitud se puede determinar llamando a SimRecords#getEncodedNameLength(ContentResolver, String).

<h3>Operations </h3><dl><dd><b>Insert</b></dd>

Solo ElementaryFiles#EF_ADN admite inserciones. SimRecords#PHONE_NUMBER es una columna necesaria. Si falta el valor proporcionado para esta columna, no es null, está vacío o infringe los requisitos descritos en la sección Datos anterior IllegalArgumentException a se producirá. Se puede omitir la SimRecords#NAME columna, pero si se proporciona y infringe cualquiera de los requisitos descritos en la sección Datos anterior IllegalArgumentException , se producirá una excepción .

Si una inserción no es posible porque el archivo elemental está lleno, se producirá una IllegalStateException excepción .

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

Las actualizaciones solo se pueden realizar para registros individuales en ElementaryFiles#EF_ADN. Se hace referencia a un registro específico a través del URI devuelto por SimRecords#getItemUri(int, int, int). Las actualizaciones tienen las mismas restricciones y comportamiento para y SimRecords#PHONE_NUMBERSimRecords#NAME como inserción. Sin embargo, en el caso de la actualización SimRecords#PHONE_NUMBER , se puede omitir como el registro existente ya tendrá un valor válido.

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

La eliminación solo se puede realizar para registros individuales en ElementaryFiles#EF_ADN. La eliminación de registros liberará espacio para su uso por inserciones futuras.

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

Todos los registros almacenados en un archivo elemental específico se pueden leer a través de un URI devuelto por SimRecords#getContentUri(int, int). Esta consulta siempre devuelve todos los registros; no hay compatibilidad con el filtrado a través de una selección. Un registro individual se puede consultar a través de un URI devuelto por SimRecords#getItemUri(int, int, int). Las consultas producirán una IllegalArgumentException excepción cuando la SIM con el identificador de suscripción o el tipo de archivo elemental no sean válidos o no estén disponibles.

</Dl>

Java documentación para android.provider.SimPhonebookContract.SimRecords.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.