ContactsContract.Contacts Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Constantes para a tabela de contatos, que contém um registro por agregação de contatos brutos que representam a mesma pessoa.
[Android.Runtime.Register("android/provider/ContactsContract$Contacts", DoNotGenerateAcw=true)]
public class ContactsContract.Contacts : Java.Lang.Object[<Android.Runtime.Register("android/provider/ContactsContract$Contacts", DoNotGenerateAcw=true)>]
type ContactsContract.Contacts = class
inherit Object- Herança
- Atributos
Comentários
Constantes para a tabela de contatos, que contém um registro por agregação de contatos brutos que representam a mesma pessoa.
<H3>As operações</h3><dl dt><><b>Insert</b></dt><dd>A Contact não podem ser criadas explicitamente. Quando um contato bruto é inserido, o provedor primeiro tentará encontrar um Contato representando a mesma pessoa. Se um for encontrado, a coluna do RawContacts#CONTACT_ID contato bruto obterá o _ID do Contato de agregação. Se nenhuma correspondência for encontrada, o provedor inserirá automaticamente um novo Contato e colocará seu _ID na RawContacts#CONTACT_ID coluna do contato bruto recém-inserido.</dd><dt><b>Atualização</b></dt><dd>Somente determinadas colunas de Contato são modificáveis: #STARRED, , #CUSTOM_RINGTONE. #SEND_TO_VOICEMAIL Alterar qualquer uma dessas colunas no Contato também as altera em todos os contatos brutos constituintes.</dd><dt><b>Delete</b></dt><dd>Tenha cuidado com a exclusão de Contatos! Excluir um contato agregado exclui todos os contatos brutos constituintes. Os adaptadores de sincronização correspondentes observarão as exclusões de seus respectivos contatos brutos e os removerão do armazenamento de back-end.</dd><dt><b>Query</b></dt><dd><ul><li>Se precisar ler um contato individual, considere usar #CONTENT_LOOKUP_URI em vez de #CONTENT_URI.</li><li>Se você precisar procurar um contato pelo número de telefone, use PhoneLookup#CONTENT_FILTER_URI PhoneLookup.CONTENT_FILTER_URI, que é otimizado para essa finalidade.</li><li>Se você precisar procurar um contato por nome parcial, por exemplo, para produzir sugestões de filtro conforme o tipo, use o #CONTENT_FILTER_URI URI.
<li>Se você precisar procurar um contato por algum elemento de dados, como endereço de email, apelido etc, use uma consulta na ContactsContract.Data tabela. O resultado conterá ID de contato, nome etc. </ul>/dd<>/dl<>h2<Columns>/h2<>table class="jd-sumtable"<>tr<>th colspan='4'Contacts<>/th<>/tr<>tr<>td<long>/td td<><>#_ID/td td<><read-only>/td td<>td<Row ID.> Considere usar #LOOKUP_KEY em vez disso.</td/tr><tr><td>String</td td><><>/td td#LOOKUP_KEY<>read-only</td td td><>Um valor opaco que contém dicas sobre como localizar o contato se sua ID de linha foi alterada como resultado de uma sincronização ou agregação.<></td></tr><tr><td>long</td><td>NAME_RAW_CONTACT_ID</td td><>read-only</td td><>the ID do contato bruto que contribui com o nome de exibição para o contato agregado. Durante a agregação, um dos contatos brutos constituintes é escolhido usando uma heurística: um nome mais longo ou um nome com marcas mais diacríticas ou mais caracteres maiúsculos é escolhido.</td></tr><tr><td>String</td><td>DISPLAY_NAME_PRIMARY</td td><>read-only</td td><td>The display name for the contact. É o nome de exibição que contribuiu com o contato bruto referenciado pela coluna NAME_RAW_CONTACT_ID.</td/tr><tr><td>long</td><><>/td td td#PHOTO_ID<>read-only</td td><td>Reference to the row in the < table holding the photo.>ContactsContract.Data Essa linha tem o tipo CommonDataKinds.Photo#CONTENT_ITEM_TYPEmime. O valor desse campo é calculado automaticamente com base no CommonDataKinds.Photo#IS_SUPER_PRIMARY campo das linhas de dados desse tipo de mime.</td></tr><td><>long</td><>#PHOTO_URI</td td td><>read-only</td td td><>A URI que pode ser usado para recuperar a foto em tamanho real do contato. Esta coluna é o método preferencial para recuperar a foto de contato.</td/tr><tr><td>long</td><><>/td td td#PHOTO_THUMBNAIL_URI<>read-only</td td><>A URI que pode ser usado para recuperar a miniatura da foto do contato.<> Esta coluna é o método preferencial para recuperar a foto de contato.</td/tr><tr><td>int</td><><>/td td td#IN_VISIBLE_GROUP<>read-only</td td><td>Um indicador de se esse contato deve estar visível na interface do usuário.<> "1" se o contato tiver pelo menos um contato bruto que pertença a um grupo visível; "0" caso contrário.</td/tr><tr><td>int</td><><>/td td td#HAS_PHONE_NUMBER<>read-only</td td><td>Um indicador de se esse contato tem pelo menos um número de telefone.<> "1" se houver pelo menos um número de telefone, "0" caso contrário.</td/tr><tr><td>int</td td><><>/td td#STARRED<>read/write</td td><td>Um indicador para contatos favoritos: '1' se favorito, '0' caso contrário.<> Quando contatos brutos são agregados, esse campo é calculado automaticamente: se algum contato bruto constituinte for estrelado, esse campo será definido como '1'. Definir esse campo altera automaticamente o campo correspondente em todos os contatos brutos constituintes.</td/tr><tr><td>String</td td><><>/td td#CUSTOM_RINGTONE<>read/write</td td td><>Um toque personalizado associado a um contato.<> Normalmente, esse é o URI retornado por uma atividade iniciada com a android.media.RingtoneManager#ACTION_RINGTONE_PICKER intenção.</td></tr><tr><td>int</td></td td>#SEND_TO_VOICEMAIL< td><>read/write</td td><td>Um indicador de se as chamadas desse contato devem ser encaminhadas diretamente para a caixa postal ('1') ou não ('0'). Quando contatos brutos são agregados, esse campo é calculado automaticamente: se todos os contatos brutos constituintes tiverem SEND_TO_VOICEMAIL=1, esse campo será definido como '1'. Definir esse campo altera automaticamente o campo correspondente em todos os contatos brutos constituintes.</td/tr><tr><td>int</td td><><>/td td#CONTACT_PRESENCE<>read-only</td td><>contact IM presence status.<> Consulte StatusUpdates as definições de status individuais. Computado automaticamente como a maior presença de todos os contatos brutos constituintes. O provedor pode optar por não armazenar esse valor no armazenamento persistente. A expectativa é que o status de presença seja atualizado regularmente.</td/tr><tr><td>String</td td><><>/td td#CONTACT_STATUS<>read-only</td td><td>Contact's latest status update.<> Computado automaticamente como o mais recente de todas as atualizações de status de contatos brutos constituintes.</td/tr><tr><td>long</td><><>/td td td#CONTACT_STATUS_TIMESTAMP<>read-only</td td><td>O tempo absoluto em milissegundos quando o status mais recente foi inserido/atualizado.<></td/tr><tr><td>String</td td><><>/td td#CONTACT_STATUS_RES_PACKAGE<>read-only</td td><td> O pacote que contém recursos para este status: rótulo e ícone.<></td/tr><tr><td>long</td><><>/td td td#CONTACT_STATUS_LABEL<>read-only</td td><td>A ID do recurso do rótulo que descreve a origem do status de contato, por exemplo, "Google Talk".<> Esse recurso tem o escopo definido pelo #CONTACT_STATUS_RES_PACKAGE.</td/tr><tr><td>long</td><><>/td td td#CONTACT_STATUS_ICON<>read-only</td td><td>The resource ID of the icon for the source of contact status.<> Esse recurso tem o escopo definido pelo #CONTACT_STATUS_RES_PACKAGE.</td></tr></table>
Java documentação para android.provider.ContactsContract.Contacts.
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.
Construtores
| Nome | Description |
|---|---|
| ContactsContract.Contacts(IntPtr, JniHandleOwnership) |
Um construtor usado ao criar representações gerenciadas de objetos JNI; chamado pelo runtime. |
Campos
| Nome | Description |
|---|---|
| ContentItemType |
O tipo MIME de um |
| ContentType |
O tipo MIME de |
| ContentVcardType |
O tipo MIME de um |
| ExtraAddressBookIndex |
Adicione esse parâmetro de consulta a um URI para obter contagens de linhas de volta agrupadas pelo índice do catálogo de endereços como extras de cursor. |
| ExtraAddressBookIndexCounts |
A matriz de contagens de grupo para o grupo correspondente. |
| ExtraAddressBookIndexTitles |
A matriz de títulos de índice do catálogo de endereços, que são retornados na mesma ordem que os dados no cursor. |
| QueryParameterVcardNoPhoto |
Parâmetro booliano que pode ser usado com |
Propriedades
| Nome | Description |
|---|---|
| Class |
Retorna a classe de runtime deste |
| ContentFilterUri |
O URI de estilo content:// usado para a funcionalidade "tipo a filtro" no |
| ContentFrequentUri |
O URI de estilo content:// para mostrar uma lista de pessoas contatadas com frequência. |
| ContentGroupUri | |
| ContentLookupUri |
Um URI de estilo content:// para esta tabela que deve ser usado para criar atalhos ou criar links de longo prazo para contatos. |
| ContentMultiVcardUri |
Base |
| ContentStrequentFilterUri |
O URI de estilo content:// usado para a funcionalidade "tipo a filtro" no |
| ContentStrequentUri |
O URI de estilo de content:// desta tabela juntou-se a dados úteis de |
| ContentUri |
O URI de estilo content:// para esta tabela |
| ContentVcardUri |
Base |
| EnterpriseContentFilterUri |
Ele dá suporte à semântica |
| EnterpriseContentUri |
URI usado para obter todos os contatos do usuário de chamada e do perfil gerenciado que está vinculado a ele. |
| Handle |
O identificador para a instância subjacente do Android. (Herdado de Object) |
| JniIdentityHashCode |
Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade. (Herdado de Object) |
| JniManagedPeerState |
Constantes para a tabela de contatos, que contém um registro por agregação de contatos brutos que representam a mesma pessoa. (Herdado de JavaObject) |
| JniPeerMembers |
Constantes para a tabela de contatos, que contém um registro por agregação de contatos brutos que representam a mesma pessoa. |
| PeerReference |
Obtém a referência de objeto JNI para este par Java. (Herdado de Object) |
| ThresholdClass |
Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código. |
| ThresholdType |
Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código. |
Métodos
| Nome | Description |
|---|---|
| Clone() |
Cria e retorna uma cópia desse objeto. (Herdado de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Constantes para a tabela de contatos, que contém um registro por agregação de contatos brutos que representam a mesma pessoa. (Herdado de JavaObject) |
| Dispose() |
Libera os recursos mantidos por esse par Java. (Herdado de Object) |
| Dispose(Boolean) |
Libera os recursos mantidos por esse par Java. (Herdado de Object) |
| DisposeUnlessReferenced() |
Constantes para a tabela de contatos, que contém um registro por agregação de contatos brutos que representam a mesma pessoa. (Herdado de JavaObject) |
| Equals(Object) |
Constantes para a tabela de contatos, que contém um registro por agregação de contatos brutos que representam a mesma pessoa. (Herdado de JavaObject) |
| Equals(Object) |
Indica se algum outro objeto é "igual a" este. (Herdado de Object) |
| GetHashCode() |
Retorna um valor de código hash para o objeto. (Herdado de Object) |
| GetLookupUri(ContentResolver, Uri) |
Cria um |
| GetLookupUri(Int64, String) |
Crie uma |
| IsEnterpriseContactId(Int64) |
Retorne |
| JavaFinalize() |
Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto. (Herdado de Object) |
| LookupContact(ContentResolver, Uri) |
Calcula um URI de conteúdo (veja |
| MarkAsContacted(ContentResolver, Int64) |
Obsoleto.
Marque um contato como tendo sido contatado. |
| Notify() |
Ativa um único thread que está aguardando no monitor deste objeto. (Herdado de Object) |
| NotifyAll() |
Ativa todos os threads que estão aguardando no monitor deste objeto. (Herdado de Object) |
| OpenContactPhotoInputStream(ContentResolver, Uri, Boolean) |
Abre um InputStream para a foto dos contatos e retorna a foto como um fluxo de bytes. |
| OpenContactPhotoInputStream(ContentResolver, Uri) |
Abre um InputStream para a foto em miniatura dos contatos e retorna a foto como um fluxo de bytes. |
| SetHandle(IntPtr, JniHandleOwnership) |
Define a propriedade Handle (Herdado de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Constantes para a tabela de contatos, que contém um registro por agregação de contatos brutos que representam a mesma pessoa. (Herdado de JavaObject) |
| ToArray<T>() |
Cria uma matriz gerenciada com base nesse wrapper de matriz Java. (Herdado de Object) |
| ToString() |
Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object) |
| UnregisterFromRuntime() |
Cancela o registro desse par Java do runtime de interoperabilidade. (Herdado de Object) |
| Wait() |
Faz com que o thread atual aguarde até ser despertado, normalmente por ser <notificado/em> ou <em>interrompido</em>.<> (Herdado de Object) |
| Wait(Int64, Int32) |
Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object) |
| Wait(Int64) |
Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object) |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IJavaPeerable.Disposed() |
Constantes para a tabela de contatos, que contém um registro por agregação de contatos brutos que representam a mesma pessoa. (Herdado de JavaObject) |
| IJavaPeerable.Finalized() |
Constantes para a tabela de contatos, que contém um registro por agregação de contatos brutos que representam a mesma pessoa. (Herdado de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Constantes para a tabela de contatos, que contém um registro por agregação de contatos brutos que representam a mesma pessoa. (Herdado de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Constantes para a tabela de contatos, que contém um registro por agregação de contatos brutos que representam a mesma pessoa. (Herdado de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Constantes para a tabela de contatos, que contém um registro por agregação de contatos brutos que representam a mesma pessoa. (Herdado de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Constantes para a tabela de contatos, que contém um registro por agregação de contatos brutos que representam a mesma pessoa. (Herdado de JavaObject) |
Métodos de Extensão
| Nome | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtém o nome JNI do tipo da instância |
| JavaAs<TResult>(IJavaPeerable) |
Tente coagir a digitar |
| JavaCast<TResult>(IJavaObject) |
Executa uma conversão de tipo marcada por runtime do Android. |
| JavaCast<TResult>(IJavaObject) |
Constantes para a tabela de contatos, que contém um registro por agregação de contatos brutos que representam a mesma pessoa. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Tente coagir a digitar |