SimPhonebookContract.SimRecords Classe

Definizione

[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

Ereditarietà

Object

JavaObject

Object

SimPhonebookContract.SimRecords

Attributi

RegisterAttribute

Commenti

Costanti per i record di contatto in una scheda SIM.

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

I dati vengono archiviati in un file elementare specifico su una scheda SIM specifica e sono isolati l'uno dall'altro. Le schede SIM sono identificate dall'ID sottoscrizione. Le schede SIM potrebbero non supportare tutti o anche i tipi di file elementari. Una SIM avrà vincoli sui valori dei dati che possono essere archiviati in ogni file elementare. I SIM disponibili, i tipi di file elementari supportati e i vincoli sui dati possono essere individuati eseguendo query su ElementaryFiles#CONTENT_URI. Ogni file elementare ha una capacità fissa per il numero di record che possono essere archiviati. Questo valore può essere determinato dal valore della ElementaryFiles#MAX_RECORDS colonna.

La SimRecords#PHONE_NUMBER colonna può contenere solo caratteri di composizione e questo vale indipendentemente dalla SIM in uso. Per altri dettagli, vedere android.telephony.PhoneNumberUtils#isDialable(char). Inoltre, il numero di telefono può contenere al massimo ElementaryFiles#PHONE_NUMBER_MAX_LENGTH caratteri. La SimRecords#NAME colonna può contenere al massimo ElementaryFiles#NAME_MAX_LENGTH byte quando viene codificata per l'archiviazione nella SIM. La codifica viene eseguita internamente e quindi il nome deve essere fornito a queste API del provider come stringa Java, ma il numero di byte necessari per codificarlo per l'archiviazione varia a seconda dei caratteri contenuti. Questa lunghezza può essere determinata chiamando SimRecords#getEncodedNameLength(ContentResolver, String).

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

Supporta solo ElementaryFiles#EF_ADN inserimenti. SimRecords#PHONE_NUMBER è una colonna obbligatoria. Se il valore specificato per questa colonna è mancante, null, vuoto o viola i requisiti descritti nella sezione Dati sopra verrà generata un'eccezione IllegalArgumentException . La SimRecords#NAME colonna può essere omessa, ma se specificata e viola uno dei requisiti descritti nella sezione Dati sopra verrà generata un'eccezione IllegalArgumentException .

Se un inserimento non è possibile perché il file elementare è pieno, verrà generata un'eccezione IllegalStateException .

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

Gli aggiornamenti possono essere eseguiti solo per singoli record in ElementaryFiles#EF_ADN. Viene fatto riferimento a un record specifico tramite l'URI restituito da SimRecords#getItemUri(int, int, int). Gli aggiornamenti hanno gli stessi vincoli e comportamento per SimRecords#PHONE_NUMBER e SimRecords#NAME come inserimento. Tuttavia, nel caso di aggiornamento SimRecords#PHONE_NUMBER può essere omesso perché il record esistente avrà già un valore valido.

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

L'eliminazione può essere eseguita solo per singoli record in ElementaryFiles#EF_ADN. L'eliminazione dei record libera spazio per l'uso da parte degli inserimenti futuri.

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

Tutti i record archiviati in un file elementare specifico possono essere letti tramite un URI restituito da SimRecords#getContentUri(int, int). Questa query restituisce sempre tutti i record; non esiste alcun supporto per il filtro tramite una selezione. È possibile eseguire query su un singolo record tramite un URI restituito da SimRecords#getItemUri(int, int, int). Le query generano un'eccezione IllegalArgumentException quando la SIM con l'ID sottoscrizione o il tipo di file elementare non sono validi o non disponibili.

</Dl>

per android.provider.SimPhonebookContract.SimRecords.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.