Windows Phone SDK 7.1 提供了获取联系人列表信息的API,虽然是只读的,但是相比SDK 7.0已经很不错了。联系信息获取的相关API位于Microsoft.Phone.UserData空间下,对于联系人获取主要用到两个类:Contacts, Contact。下面给出获取联系人信息的实例以及注意事项。
Windows Phone 获取联系人
1.首先创建一个Contacts对象,查询联系人信息的操作为异步处理,所以需要添加一个查询完成事件(SearchCompleted)
Contacts contacts = new Contacts();
contacts.SearchCompleted += new EventHandler(SearchCompleted);
2.接下来就是调用查询,开始查找联系人
contacts.SearchAsync(String.Empty, FilterKind.DisplayName, null);
SearchAsync (stringfilter, FilterKind filterKind, Object state) 在用户的联系人数据中异步搜索联系人信息,filter为筛选器,FilterKind筛选器种类,上列中为查询所有联系人信息。
3.查询完成后会调用查询完成事件(SearchCompleted)
private void SearchCompleted(object sender, ContactsSearchEventArgs e)
{
foreach (Contact result in e.Results)
{
//联系人姓名
String name = Contact.DisplayName;
//联系人电话
ContactPhoneNumber phoneNumber = Contact.PhoneNumbers.FirstOrDefault();
String phone = String.Empty;
if (phoneNumber != null)
{
phone = phoneNumber.PhoneNumber;
}
//联系人地址
ContactAddress address = Contact.Addresses.FirstOrDefault();
String addr = String.Empty;
if (address != null)
{
addr = address.PhysicalAddress.AddressLine1;
}
//联系人Email
ContactEmailAddress emailAddress = Contact.EmailAddresses.FirstOrDefault();
String email = String.Empty;
if (emailAddress != null)
{
email = emailAddress.EmailAddress;
}
//…………
}
}
注1:FirstOrDefault()为System.Linq.Enumerable类的函数,需要手动添加命名空间using System.Linq;
注2:获取联系人地址PhysicalAddress.AddressLine1需要添加引用System.Device。
Windows Phone 获取联系人
前面介绍Windows Phone 获取联系人,通过Windows Phone SDK 7.1提供的API来获取联系人信息。但是对于添加联系人并没有可以直接使用的API,我们只能通过选择器(Choosers)来实现添加联系人信息的操作。
SaveContactTask 提供用于启动联系人应用程序以及使用户能够保存联系人的方法和事件。代码编写示例如下。
1.创建选择器并添加选择器操作完成事件(Completed)
SaveContactTask saveContact = new SaveContactTask();
saveContact.Completed += new EventHandler(saveCompleted);
2.为选择器赋值(联系人信息)并调用选择器
saveContact.FirstName = "宇之乐";
saveContact.MobilePhone = "13888888888";
saveContact.HomeAddressStreet = "江苏省南京市";
saveContact.PersonalEmail = "[email protected]";
saveContact.Show();
3.选择器操作完成事件
void saveCompleted(object sender, SaveContactResult e)
{
switch (e.TaskResult)
{
case TaskResult.OK:
MessageBox.Show("保存联系人成功!");
break;
case TaskResult.Cancel:
MessageBox.Show("用户取消了操作!");
break;
case TaskResult.None:
MessageBox.Show("联系人未被保存!");
break;
}
}
目前对联系人的操作只有查询和添加,暂时还无法进行修改和删除联系人的相关操作。只能有用户手动通过系统处理了。