今天给大家介绍下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<string, object> 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<string, object> props = await contact.GetPropertiesAsync(); props[KnownContactProperties.Email] = email; IDictionary<string, object> extprops = await contact.GetExtendedPropertiesAsync(); extprops["Codename"] = codeName; await contact.SaveAsync(); } }
修改联系人的过程和创建十分相似 区别就是可以通过一个RemoteId 或者 ID 获取到目标联系人对要修改的字段进行修改保存。
3. 删除联系人
ContactQueryResult result = store.CreateContactQuery(); IReadOnlyList<StoredContact> contacts = await result.GetContactsAsync(); List<StoredContact> listSC = contacts.ToList(); await store.DeleteContactAsync(listSC[0].Id);
删除联系人更为简单 只需要StoredContact的ID就可以进行删除操作。