Windows Phone 8 人脉 people hub 通讯录管理

llcong

　　今天给大家介绍下Windows Phone 8 的 people hub - 人脉相关的API，了解Windows phone的同学一定都知道在windows phone7的API对通讯录的操作权限是只读的 不能直接向通讯录中添加联系人 只能通过其他方式同步联系人 例如：exchange， save deloge，这样对一些通讯录的应用带来了很多用户体验上制约，不过在microsoft最新的Windows phone 8 SDK中打开的这一限制，支持API级别的通讯录增删改查，下面我就给大家介绍一下。
　　当然在写代码之前不要忘记设置WMAppManifest文件

　　1. 通讯录中添加联系人
　　首先给大家介绍的是如何创建一个联系人至联系人列表，在SDK 8.0 中的 ContactStore 他用于联系人操作



            ContactStore store = await ContactStore.CreateOrOpenAsync(
ContactStoreSystemAccessMode.ReadWrite,
ContactStoreApplicationAccessMode.ReadOnly);
　　可以看到CreateOrOpenAsync方法中有两个参数 分别是 ContactStoreSystemAccessMode 和 ContactStoreApplicationAccessMode 两个枚举值 这两个枚举值比较关键 前者是声明当前应用所创建的联系人十分可以在People hub中编辑改写，后者是声明在其他应用程序中的现实访问权限.

　　ReadOnly 在people hub中对于系统用户来说是只读的 ReadWrite 顾名思义就是可读写的。
　　

　　LimitedReadOnly 对于其他应用程序来说能看到的信息只是描述信息和现实图片 ReadOnly则是可以读取全部信息的。
　　添加一个联系人的代码十分简单



        async public void AddContact()
{
ContactStore store = await ContactStore.CreateOrOpenAsync(
ContactStoreSystemAccessMode.ReadWrite,
ContactStoreApplicationAccessMode.ReadOnly);
StoredContact contact = new StoredContact(store);
//contact.RemoteId = "123";
//contact.Id 只读属性添加成功后系统会自动分配
contact.GivenName = txtGivenName.Text;
contact.FamilyName = txtFamilyName.Text;
IDictionary props = await contact.GetPropertiesAsync();
props.Add(KnownContactProperties.Email, txtMail.Text);
props.Add(KnownContactProperties.Telephone, txtPhone.Text);
await contact.SaveAsync();
MessageBox.Show("save done");
}
　　这里给大家提一下RemoteId 是一个识别联系人的标示 可以是GUID进行同步修改的时候可以为mapping service上的数据所用，在应用中也支持RemoteId的查找联系人。
　　2. 修改联系人



        async private void UpdateContact(string remoteId, string givenName, string familyName, string email, string codeName)
{
ContactStore store = await ContactStore.CreateOrOpenAsync();
StoredContact contact = await store.FindContactByRemoteIdAsync(remoteId);
if (contact != null)
{
contact.GivenName = givenName;
contact.FamilyName = familyName;
IDictionary props = await contact.GetPropertiesAsync();
props[KnownContactProperties.Email] = email;
IDictionary extprops = await contact.GetExtendedPropertiesAsync();
extprops["Codename"] = codeName;
await contact.SaveAsync();
}
}
　　修改联系人的过程和创建十分相似 区别就是可以通过一个RemoteId 或者 ID 获取到目标联系人对要修改的字段进行修改保存。
　　3. 删除联系人



            ContactQueryResult result = store.CreateContactQuery();
IReadOnlyList contacts = await result.GetContactsAsync();
List listSC = contacts.ToList();
await store.DeleteContactAsync(listSC[0].Id);   
　　删除联系人更为简单 只需要StoredContact的ID就可以进行删除操作。
　　4. 查询联系人
　　查询联系人仍然支持7.5的查询方式（支持过滤条件支持linq）



private void ButtonContacts_Click(object sender, RoutedEventArgs e)
{
Contacts cons = new Contacts();
//Identify the method that runs after the asynchronous search completes.
cons.SearchCompleted += new EventHandler(Contacts_SearchCompleted);
//Start the asynchronous search.
cons.SearchAsync(String.Empty, FilterKind.None, "Contacts Test #1");
}
void Contacts_SearchCompleted(object sender, ContactsSearchEventArgs e)
{
//Do something with the results.
MessageBox.Show(e.Results.Count().ToString());
}
　　通讯录搜索：http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh286416(v=vs.105).aspx
　　过滤条件：http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh286417(v=vs.105).aspx
　　除此之外还支持使用
　　CreateContactQuery 获取ContactStore联系人列表 支持返回属性设置和排序



        async private void QueryWithDesiredFields()
{
ContactStore store = await ContactStore.CreateOrOpenAsync();
ContactQueryOptions options = new ContactQueryOptions();
options.DesiredFields.Add(KnownContactProperties.Email);
options.OrderBy = ContactQueryResultOrdering.FamilyNameGivenName;
ContactQueryResult result = store.CreateContactQuery(options);
IReadOnlyList contacts = await result.GetContactsAsync();
}
　　经过上述应用添加到people hub中的联系人显示也是可以筛选显示的
　　进入 人脉 - 设置 - 筛选我的联系人列表 - 选择要显示来自应用的联系人即可



　　默认都是选中的
　　MSDN连接：http://msdn.microsoft.com/en-us/library/windowsphone/develop/jj207024(v=vs.105).aspx
　　欢迎大家在这里和我沟通交流或者在新浪微博上 @王博_Nick