ContactsContract.Contacts Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Costanti per la tabella contatti, che contiene un record per aggregazione di contatti non elaborati che rappresentano la stessa persona.
[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
- Ereditarietà
- Attributi
Commenti
Costanti per la tabella contatti, che contiene un record per aggregazione di contatti non elaborati che rappresentano la stessa persona. <h3 Operations</h3>><dl><dt b>Insert</b></dt dd<><>A Contact non può essere creato in modo esplicito.> Quando viene inserito un contatto non elaborato, il provider tenterà prima di tutto di trovare un contatto che rappresenta la stessa persona. Se viene trovato, la colonna del RawContacts#CONTACT_ID
contatto non elaborato ottiene la _ID del contatto aggregato. Se non viene trovata alcuna corrispondenza, il provider inserisce automaticamente un nuovo contatto e inserisce il relativo _ID nella RawContacts#CONTACT_ID
colonna del contatto non elaborato appena inserito.</dd><dt b>Update</b></dt><dd>><Solo alcune colonne di Contatto sono modificabili: #STARRED
, , #CUSTOM_RINGTONE
#SEND_TO_VOICEMAIL
. La modifica di una di queste colonne nel contatto cambia anche in tutti i contatti non elaborati costitutivi.</dd><dt b>Delete</b></dt>><<dd>Prestare attenzione all'eliminazione di Contatti! L'eliminazione di un contatto aggregato elimina tutti i contatti non elaborati costitutivi. Gli adattatori di sincronizzazione corrispondenti noteranno le eliminazioni dei rispettivi contatti non elaborati e li rimuoveranno dall'archiviazione back-end.</dd><dt b>Query</b/dt>< dd><><<>ul><li>Se è necessario leggere un singolo contatto, prendere in considerazione l'uso #CONTENT_LOOKUP_URI
anziché .<#CONTENT_URI
/li li>><Se è necessario cercare un contatto dal numero di telefono, usare PhoneLookup#CONTENT_FILTER_URI PhoneLookup.CONTENT_FILTER_URI
, che è ottimizzato per questo scopo.</li li><>Se è necessario cercare un contatto in base al nome parziale, ad esempio per produrre suggerimenti di filtro come tipo, usare l'URI.#CONTENT_FILTER_URI
<li>Se è necessario cercare un contatto da parte di alcuni elementi dati come indirizzo di posta elettronica, nickname e così via, usare una query sulla ContactsContract.Data
tabella. Il risultato conterrà l'ID contatto, il nome e così via. </ul>/dd></dl><h2 Columns</h2>><table class="jd-sumtable"><tr><th colspan='4'Contacts></th<>/tr><tr><>< td long/td><<<>>#_ID
> read-only</td td td>><Row ID.< Si consideri invece di usare#LOOKUP_KEY
.</td></tr><tr><td>String</<>#LOOKUP_KEY
><td read-only</><>td<>>Un valore opaco che contiene hint su come trovare il contatto se l'ID riga è cambiato come risultato di una sincronizzazione o aggregazione.</td></tr><tr><td>< long/td td NAME_RAW_CONTACT_ID</><>td>><read-only</td><>ID del contatto non elaborato che contribuisce al nome visualizzato al contatto aggregato. Durante l'aggregazione uno dei contatti non elaborati costitutivi viene scelto usando un'euristica: viene scelto un nome più lungo o un nome con segni più diacritici o più caratteri maiuscoli.</td></tr><tr><td>String</td>><DISPLAY_NAME_PRIMARY</>><td read-only</td><>Il nome visualizzato per il contatto. È il nome visualizzato contribuito dal contatto non elaborato a cui fa riferimento la colonna NAME_RAW_CONTACT_ID.</td></tr><tr><td>< long/<>#PHOTO_ID
><td read-only</>><td td td<>>Riferimento alla riga nella ContactsContract.Data
tabella che contiene la foto. Tale riga ha il tipo CommonDataKinds.Photo#CONTENT_ITEM_TYPE
mime . Il valore di questo campo viene calcolato automaticamente in base al CommonDataKinds.Photo#IS_SUPER_PRIMARY
campo delle righe di dati di tale tipo mime.</td></tr><tr><td>< long/><td><#PHOTO_URI
read-only</><>td><td>URI che può essere usato per recuperare la foto full-size del contatto. Questa colonna è il metodo preferito per recuperare la foto di contatto.</td></tr><tr><td>< long/><td><#PHOTO_THUMBNAIL_URI
read-only</><>td><td>URI che può essere usato per recuperare l'anteprima della foto del contatto. Questa colonna è il metodo preferito per recuperare la foto di contatto.</td></tr><tr>><td int</<#IN_VISIBLE_GROUP
><>td read-only</><>td td><>Un indicatore di se questo contatto dovrebbe essere visibile nell'interfaccia utente. "1" se il contatto ha almeno un contatto non elaborato che appartiene a un gruppo visibile; "0" in caso contrario.</td></tr><tr>><td int</<>td><#HAS_PHONE_NUMBER
read-only</><>td td><>Un indicatore di se questo contatto ha almeno un numero di telefono. "1" se esiste almeno un numero di telefono, "0" in caso contrario.</td></tr><tr>><td int</><td<>#STARRED
<>> read/write</td td><>Td Indicatore per i contatti preferiti: '1' se preferito, '0' in caso contrario. Quando i contatti non elaborati vengono aggregati, questo campo viene calcolato automaticamente: se vengono visualizzati contatti non elaborati costitutivi, questo campo viene impostato su '1'. L'impostazione di questo campo modifica automaticamente il campo corrispondente su tutti i contatti non elaborati costitutivi.</td></tr><tr><td>String</<<>#CUSTOM_RINGTONE
>>><td read/write</td><td td>A custom ringtone associato a un contatto. In genere questo è l'URI restituito da un'attività avviata con la android.media.RingtoneManager#ACTION_RINGTONE_PICKER
finalità.</td/tr><tr><td>int</<>td td>>><<#SEND_TO_VOICEMAIL
/td td read/write</td td>><Un indicatore se le chiamate da questo contatto devono essere inoltrate direttamente alla posta vocale ('1') o meno ('0').>< Quando i contatti non elaborati vengono aggregati, questo campo viene calcolato automaticamente: se tutti i contatti non elaborati costitutivi hanno SEND_TO_VOICEMAIL=1, questo campo viene impostato su '1'. L'impostazione di questo campo modifica automaticamente il campo corrispondente su tutti i contatti non elaborati costitutivi.</td/tr><tr><td>int</><td>#CONTACT_PRESENCE
<<>> read-only</td td<>td>Contact IM status.>< Vedere StatusUpdates
per le singole definizioni di stato. Calcolato automaticamente come la massima presenza di tutti i contatti non elaborati costitutivi. Il provider può scegliere di non archiviare questo valore nell'archiviazione persistente. L'aspettativa è che lo stato della presenza verrà aggiornato regolarmente.</td></tr><tr><td>String</<<#CONTACT_STATUS
>>td read-only</><>td td><td>Contact ultimo aggiornamento dello stato. Calcolato automaticamente come più recente degli aggiornamenti dello stato dei contatti non elaborati costitutivi.</td></tr><tr><td>< long/<>#CONTACT_STATUS_TIMESTAMP
><td read-only</><>td<>>Il tempo assoluto in millisecondi quando lo stato più recente è stato inserito/aggiornato.</td></tr><tr><td>String</<>#CONTACT_STATUS_RES_PACKAGE
><td read-only</><>td<>> td Il pacchetto contenente risorse per questo stato: etichetta e icona.</td></tr><tr><td>< long/<<>#CONTACT_STATUS_LABEL
>td read-only</>><td><>td Td L'ID risorsa dell'etichetta che descrive l'origine dello stato del contatto, ad esempio "Google Talk". Questa risorsa è con ambito dall'oggetto #CONTACT_STATUS_RES_PACKAGE
.</td></tr><tr><td>< long/><td<>#CONTACT_STATUS_ICON
read-only</<>>td><>L'ID risorsa dell'icona per l'origine dello stato del contatto. Questa risorsa è con ambito dall'oggetto #CONTACT_STATUS_RES_PACKAGE
.</td></tr></table>
Documentazione Java per android.provider.ContactsContract.Contacts
.
Le parti di questa pagina sono modifiche in base al lavoro creato e condiviso dal Android Open Source e usato in base ai termini descritti nella .
Costruttori
ContactsContract.Contacts(IntPtr, JniHandleOwnership) |
Costruttore usato durante la creazione di rappresentazioni gestite di oggetti JNI; chiamato dal runtime. |
Campi
ContentItemType |
Tipo MIME di una sottodirectory di una |
ContentType |
Tipo MIME di |
ContentVcardType |
Tipo MIME di una sottodirectory di una |
ExtraAddressBookIndex |
Costanti per la tabella contatti, che contiene un record per aggregazione di contatti non elaborati che rappresentano la stessa persona. |
ExtraAddressBookIndexCounts |
Costanti per la tabella contatti, che contiene un record per aggregazione di contatti non elaborati che rappresentano la stessa persona. |
ExtraAddressBookIndexTitles |
Costanti per la tabella contatti, che contiene un record per aggregazione di contatti non elaborati che rappresentano la stessa persona. |
QueryParameterVcardNoPhoto |
Parametro booleano che può essere usato con |
Proprietà
Class |
Restituisce la classe di runtime di questo |
ContentFilterUri |
URI di stile content:// usato per la funzionalità "type-to-filter" nell'URI |
ContentFrequentUri |
URI di stile content:// per visualizzare un elenco di persone spesso contattate. |
ContentGroupUri | |
ContentLookupUri |
URI di stile content:// per questa tabella che deve essere usato per creare collegamenti a lungo termine o creare collegamenti a lungo termine ai contatti. |
ContentMultiVcardUri |
Base |
ContentStrequentFilterUri |
URI di stile content:// usato per la funzionalità "type-to-filter" nell'URI |
ContentStrequentUri |
URI di stile content:// per questa tabella unita a dati utili da |
ContentUri |
URI di stile content:// per questa tabella |
ContentVcardUri |
Base |
EnterpriseContentFilterUri |
Supporta la semantica simile a |
EnterpriseContentUri |
URI usato per ottenere tutti i contatti dall'utente chiamante e dal profilo gestito collegato. |
Handle |
Handle all'istanza di Android sottostante. (Ereditato da Object) |
JniIdentityHashCode |
Costanti per la tabella contatti, che contiene un record per aggregazione di contatti non elaborati che rappresentano la stessa persona. (Ereditato da Object) |
JniPeerMembers |
Costanti per la tabella contatti, che contiene un record per aggregazione di contatti non elaborati che rappresentano la stessa persona. |
PeerReference |
Costanti per la tabella contatti, che contiene un record per aggregazione di contatti non elaborati che rappresentano la stessa persona. (Ereditato da Object) |
ThresholdClass |
Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. |
ThresholdType |
Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. |
Metodi
Clone() |
Crea e restituisce una copia di questo oggetto. (Ereditato da Object) |
Dispose() |
Costanti per la tabella contatti, che contiene un record per aggregazione di contatti non elaborati che rappresentano la stessa persona. (Ereditato da Object) |
Dispose(Boolean) |
Costanti per la tabella contatti, che contiene un record per aggregazione di contatti non elaborati che rappresentano la stessa persona. (Ereditato da Object) |
Equals(Object) |
Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object) |
GetHashCode() |
Restituisce un valore del codice hash per l'oggetto. (Ereditato da Object) |
GetLookupUri(ContentResolver, Uri) |
Compila uno |
GetLookupUri(Int64, String) |
Creare una |
IsEnterpriseContactId(Int64) |
Restituisce |
JavaFinalize() |
Chiamato dal Garbage Collector in un oggetto quando Garbage Collection determina che non sono presenti più riferimenti all'oggetto. (Ereditato da Object) |
LookupContact(ContentResolver, Uri) |
Calcola un URI del contenuto (vedere |
MarkAsContacted(ContentResolver, Int64) |
Obsoleti.
Contrassegnare un contatto come contattato. |
Notify() |
Riattiva un singolo thread in attesa del monitoraggio dell'oggetto. (Ereditato da Object) |
NotifyAll() |
Riattiva tutti i thread in attesa del monitoraggio dell'oggetto. (Ereditato da Object) |
OpenContactPhotoInputStream(ContentResolver, Uri) |
Apre un inputStream per la foto di anteprima dei contatti e restituisce la foto come flusso di byte. |
OpenContactPhotoInputStream(ContentResolver, Uri, Boolean) |
Apre un InputStream per la foto dei contatti e restituisce la foto come flusso di byte. |
SetHandle(IntPtr, JniHandleOwnership) |
Imposta la proprietà Handle. (Ereditato da Object) |
ToArray<T>() |
Costanti per la tabella contatti, che contiene un record per aggregazione di contatti non elaborati che rappresentano la stessa persona. (Ereditato da Object) |
ToString() |
Restituisce una rappresentazione in formato stringa dell'oggetto. (Ereditato da Object) |
UnregisterFromRuntime() |
Costanti per la tabella contatti, che contiene un record per aggregazione di contatti non elaborati che rappresentano la stessa persona. (Ereditato da Object) |
Wait() |
Causa l'attesa del thread corrente fino a quando non viene svegliata, in genere eseguendo>una notifica</em o <em interrotto</>em>>.< (Ereditato da Object) |
Wait(Int64) |
Causa l'attesa del thread corrente fino a quando non viene svegliata, in genere <>eseguendo una notifica</em o <em interrotto/>>em>o fino a quando non è trascorsa< una determinata quantità di tempo reale. (Ereditato da Object) |
Wait(Int64, Int32) |
Causa l'attesa del thread corrente fino a quando non viene svegliata, in genere <>eseguendo una notifica</em o <em interrotto/>>em>o fino a quando non è trascorsa< una determinata quantità di tempo reale. (Ereditato da Object) |
Implementazioni dell'interfaccia esplicita
IJavaPeerable.Disposed() |
Costanti per la tabella contatti, che contiene un record per aggregazione di contatti non elaborati che rappresentano la stessa persona. (Ereditato da Object) |
IJavaPeerable.DisposeUnlessReferenced() |
Costanti per la tabella contatti, che contiene un record per aggregazione di contatti non elaborati che rappresentano la stessa persona. (Ereditato da Object) |
IJavaPeerable.Finalized() |
Costanti per la tabella contatti, che contiene un record per aggregazione di contatti non elaborati che rappresentano la stessa persona. (Ereditato da Object) |
IJavaPeerable.JniManagedPeerState |
Costanti per la tabella contatti, che contiene un record per aggregazione di contatti non elaborati che rappresentano la stessa persona. (Ereditato da Object) |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
Costanti per la tabella contatti, che contiene un record per aggregazione di contatti non elaborati che rappresentano la stessa persona. (Ereditato da Object) |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Costanti per la tabella contatti, che contiene un record per aggregazione di contatti non elaborati che rappresentano la stessa persona. (Ereditato da Object) |
IJavaPeerable.SetPeerReference(JniObjectReference) |
Costanti per la tabella contatti, che contiene un record per aggregazione di contatti non elaborati che rappresentano la stessa persona. (Ereditato da Object) |
Metodi di estensione
JavaCast<TResult>(IJavaObject) |
Esegue una conversione dei tipi controllati dal runtime Android. |
JavaCast<TResult>(IJavaObject) |
Costanti per la tabella contatti, che contiene un record per aggregazione di contatti non elaborati che rappresentano la stessa persona. |
GetJniTypeName(IJavaPeerable) |
Costanti per la tabella contatti, che contiene un record per aggregazione di contatti non elaborati che rappresentano la stessa persona. |