SimPhonebookContract.SimRecords Classe

Definição

[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

Herança

Object

JavaObject

Object

SimPhonebookContract.SimRecords

Atributos

RegisterAttribute

Comentários

Constantes para os registros de contato em um cartão SIM.

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

Os dados são armazenados em um arquivo elementar específico em um cartão SIM específico e eles são isolados uns dos outros. Os cartões SIM são identificados pela ID da assinatura. Os cartões SIM podem não dar suporte a todos ou mesmo a nenhum dos tipos de arquivo elementares. Um SIM terá restrições sobre os valores dos dados que podem ser armazenados em cada arquivo elementar. Os SIMs disponíveis, seus tipos de arquivo elementar com suporte e as restrições nos dados podem ser descobertos consultando ElementaryFiles#CONTENT_URI. Cada arquivo elementar tem uma capacidade fixa para o número de registros que podem ser armazenados. Isso pode ser determinado a partir do valor da ElementaryFiles#MAX_RECORDS coluna.

A SimRecords#PHONE_NUMBER coluna só pode conter caracteres discáveis e isso se aplica independentemente do SIM que está sendo usado. Confira android.telephony.PhoneNumberUtils#isDialable(char) para saber mais. Além disso, o número de telefone pode conter, no máximo ElementaryFiles#PHONE_NUMBER_MAX_LENGTH , caracteres. A SimRecords#NAME coluna pode conter no máximo ElementaryFiles#NAME_MAX_LENGTH bytes quando é codificada para armazenamento no SIM. A codificação é feita internamente e, portanto, o nome deve ser fornecido a essas APIs de provedor como um Java String, mas o número de bytes necessários para codificá-lo para armazenamento variará dependendo dos caracteres que ele contém. Esse comprimento pode ser determinado chamando SimRecords#getEncodedNameLength(ContentResolver, String).

<Operações h3>/h3<>dl<>dd<b><Insert>/b</><dd>

Só ElementaryFiles#EF_ADN dá suporte a inserções. SimRecords#PHONE_NUMBER é uma coluna necessária. Se o valor fornecido para esta coluna estiver ausente, nulo, vazio ou violar os requisitos discutidos na seção Dados acima de um IllegalArgumentException será gerado. A SimRecords#NAME coluna pode ser omitida, mas se fornecida e viola qualquer um dos requisitos discutidos na seção Dados acima de um IllegalArgumentException será lançada.

Se uma inserção não for possível porque o arquivo elementar está cheio, um IllegalStateException será gerado.

<dd><b>Atualização</b></dd>

As atualizações só podem ser executadas para registros individuais em ElementaryFiles#EF_ADN. Um registro específico é referenciado por meio do Uri retornado por SimRecords#getItemUri(int, int, int). As atualizações têm as mesmas restrições e comportamento para o SimRecords#PHONE_NUMBER e SimRecords#NAME como inserir. No entanto, no caso de atualização, pode SimRecords#PHONE_NUMBER ser omitido, pois o registro existente já terá um valor válido.

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

A exclusão só pode ser executada para registros individuais em ElementaryFiles#EF_ADN. A exclusão de registros liberará espaço para uso por inserções futuras.

<dd><b>Consulta</b></dd>

Todos os registros armazenados em um arquivo elementar específico podem ser lidos por meio de um Uri retornado por SimRecords#getContentUri(int, int). Essa consulta sempre retorna todos os registros; não há suporte para filtragem por meio de uma seleção. Um registro individual pode ser consultado por meio de um Uri retornado por SimRecords#getItemUri(int, int, int). As consultas gerarão um IllegalArgumentException quando o SIM com a ID da assinatura ou o tipo de arquivo elementar estiver inválido ou indisponível.

</dl>

Java documentação para android.provider.SimPhonebookContract.SimRecords.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.