Xamarin.Essentials:Kişiler
Kişiler sınıfı, kullanıcının bir kişiyi seçmesine ve bu kişiyle ilgili bilgileri almasına olanak tanır.
Bu API'yi kullanmaya başlamak için kitaplığın projelerinizde düzgün yüklendiğinden ve ayarlandığından emin olmak için Xamarin.Essentials kullanmaya başlama kılavuzunu okuyun.
Kişiler işlevine erişmek için aşağıdaki platforma özgü kurulum gereklidir.
İzin ReadContacts
gereklidir ve Android projesinde yapılandırılmalıdır. Bu, aşağıdaki yollarla eklenebilir:
Özellikler klasörünün altındaki 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ındaki AndroidManifest.xml dosyasını açın ve bildirim düğümünün içine aşağıdakileri ekleyin.
<uses-permission android:name="android.permission.READ_CONTACTS" /> />
Veya Android projesine sağ tıklayıp projenin özelliklerini açın. Android Bildirimi altında Gerekli izinler: alanını bulun ve bu izni denetleyin. Bu, AndroidManifest.xml dosyasını otomatik olarak güncelleştirir.
Kişi iletişim kutusu aranarak Contacts.PickContactAsync()
görüntülenir ve 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.
}
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.
}
cancellationToken
yöntemindekiGetAllAsync
parametresi yalnızca UWP üzerinde kullanılır.