Xamarin.Essentials: Kişiler

  • Makale
  • Okumak için 2 dakika

Kişiler sınıfı, kullanıcının bir kişi seçmesini ve onunla ilgili bilgileri almasına imkan tanır.

başlarken

Bu API 'yi kullanmaya başlamak için, kitaplığın projelerinizde düzgün bir şekilde yüklendiğinden ve ayarlandığından emin olmak için Başlarken Kılavuzunu okuyun.

Kişiler işlevine erişmek için aşağıdaki platforma özgü kurulum gereklidir.

ReadContactsİzin gereklidir ve Android projesinde yapılandırılması gerekir. Bu, aşağıdaki yollarla eklenebilir:

Özellikler klasörünün altında AssemblyInfo. cs dosyasını açın ve aşağıdakileri ekleyin:

[assembly: UsesPermission(Android.Manifest.Permission.ReadContacts)]

VEYA Android bildirimini güncelleştir:

Özellikler klasörünün altında AndroidManifest.xml dosyasını açın ve bildirim düğümünün içine aşağıdakini ekleyin.

<uses-permission android:name="android.permission.READ_CONTACTS" /> />

Ya da Android projesine sağ tıklayıp projenin özelliklerini açın. Android bildirimi altında gerekli izinleri bulun: alanı ve bu izni denetleyin. Bu, AndroidManifest.xml dosyasını otomatik olarak güncelleştirir.

Bir kişi seçin

Contacts.PickContactAsync()İletişim kutusunu çağırarak kullanıcının kullanıcı hakkında bilgi almasına izin verir.

try
{
    var contact = await Contacts.PickContactAsync();

    if(contact == null)
        return;

    var id = contact.Id;
    var namePrefix = contact.NamePrefix;
    var givenName = contact.GivenName;
    var middleName = contact.MiddleName;
    var familyName = contact.FamilyName;
    var nameSuffix = contact.NameSuffix;
    var displayName = contact.DisplayName;
    var phones = contact.Phones; // List of phone numbers
    var emails = contact.Emails; // List of email addresses
}
catch (Exception ex)
{
    // Handle exception here.
}

Tüm kişileri al

ObservableCollection<Contact> contactsCollect = new ObservableCollection<Contact>();

try
{
    // cancellationToken parameter is optional
    var cancellationToken = default(CancellationToken);
    var contacts = await Contacts.GetAllAsync(cancellationToken);

    if (contacts == null)
        return;

    foreach (var contact in contacts)
        contactsCollect.Add(contact);
}
catch (Exception ex)
{
    // Handle exception here.
}

Platform farkları

  • cancellationTokenGetAllAsync Yöntemdeki PARAMETRESI yalnızca UWP üzerinde kullanılır.

API