WP8 电话本编程
通讯录搜索：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
程序联系人存储的API在空间Windows.Phone.PersonalInformation下，下面来看一下如何去使用这些API来操作联系人。
ContactStore类和StoredContact类
ContactStore类表示一个Windows Phone应用程序的自定义联系人存储，它是应用程序存储的一个管理者，负责管理应用程序所创建的联系人。
StoredContact类表示一个应用程序自定义的联系人存储，它继承了IContactInformation接口，所有由应用程序创建的联系人都是一个StoredContact类的对象。
这两个类的具体用法，请查看帮助。
只读联系人访问
1 private void Button_Click_ReadContact(object sender, RoutedEventArgs e) 2 { 3 Contacts cons = new Contacts(); 4 cons.SearchCompleted += new EventHandler<ContactsSearchEventArgs>(Contacts_SearchCompleted); 5 // 参数1： 关键字；参数2：过滤类型，包含显示名称、电话号码、邮件地址、是否固定到开始屏幕等 6 cons.SearchAsync("139", FilterKind.PhoneNumber, "状态"); 7 }
1 void Contacts_SearchCompleted(object sender, ContactsSearchEventArgs e) 2 { 3 //获取到的联系人的集合 4 listbox1.ItemsSource = e.Results; 5 }
(1) 设置工程属性中的 WMAppManifest 文件
钩选 ID_CAP_CONTACTS 项以支持电话本操作
(2) 在 WP SDK 8.0 中 ContactStore 用于联系人操作
(3) 增加联系人
新增程序联系人需要先创建或者打开程序的联系人存储ContactStore，并且可以设置该程序联系人存储的被访问权限。
第一种方法：直接通过联系人存储来创建
1 async Task Add(string familyName, string givenName) 2 { 3 ContactStore store = await ContactStore.CreateOrOpenAsync(); 4 StoredContact contact = new StoredContact(store); 5 contact.FamilyName = familyName; 6 contact.GivenName = givenName; 7 8 // 获取已知联系人属性 9 IDictionary<string, object> props = await contact.GetPropertiesAsync(); 10 props.Add(KnownContactProperties.Telephone, "18600000000"); 11 12 // 获取扩展的联系人属性 13 IDictionary<string, object> extprops = await contact.GetExtendedPropertiesAsync(); 14 extprops.Add("扩展", "扩展属性"); 15 16 await contact.SaveAsync(); 17 }
1 async public void AddContact() 2 { 3 ContactStore store = await ContactStore.CreateOrOpenAsync( 4 ContactStoreSystemAccessMode.ReadWrite, 5 ContactStoreApplicationAccessMode.ReadOnly); 6 StoredContact contact = new StoredContact(store); 7 // contact.RemoteId = "123"; 8 // contact.Id // 只读属性添加成功后系统会自动分配 9 contact.GivenName = txtGivenName.Text; 10 contact.FamilyName = txtFamilyName.Text; 11 IDictionary<string, object> props = await contact.GetPropertiesAsync(); 12 props.Add(KnownContactProperties.Email, txtMail.Text); 13 props.Add(KnownContactProperties.Telephone, txtPhone.Text); 14 await contact.SaveAsync(); 15 MessageBox.Show("save done"); 16 }
第二种方式：通过ContactInformation类对象创建联系人
1 // 创建一个ContactInformation类 2 ContactInformation conInfo = new ContactInformation(); 3 // 获取ContactInformation类的属性map表 4 var properties = await conInfo.GetPropertiesAsync(); 5 // 添加电话属性 6 properties.Add(KnownContactProperties.Telephone, "123456"); 7 // 添加名字属性 8 properties.Add(KnownContactProperties.GivenName, "名字"); 9 // 创建或者打开联系人存储 10 ContactStore conStore = await ContactStore.CreateOrOpenAsync(); 11 // 保存联系人 12 StoredContact storedContact = new StoredContact(conStore, conInfo); 13 // 保存联系人 14 await storedContact.SaveAsync();
(4) 修改联系人
1 async private void UpdateContact(string remoteId, string givenName, string familyName, string email, string codeName) 2 { 3 ContactStore store = await ContactStore.CreateOrOpenAsync(); 4 StoredContact contact = await store.FindContactByRemoteIdAsync(remoteId); 5 6 7 if (contact != null) 8 { 9 contact.GivenName = givenName; 10 contact.FamilyName = familyName; 11 12 13 IDictionary<string, object> props = await contact.GetPropertiesAsync(); 14 props[KnownContactProperties.Email] = email; 15 16 17 IDictionary<string, object> extprops = await contact.GetExtendedPropertiesAsync(); 18 extprops["Codename"] = codeName; 19 20 21 await contact.SaveAsync(); 22 } 23 }
(5) 删除联系人
1 ContactQueryResult result = store.CreateContactQuery(); 2 IReadOnlyList<StoredContact> contacts = await result.GetContactsAsync(); 3 List<StoredContact> listSC = contacts.ToList(); 4 await store.DeleteContactAsync(listSC[0].Id);
(6) 查询联系人
1 private void ButtonContacts_Click(object sender, RoutedEventArgs e) 2 { 3 Contacts cons = new Contacts(); 4 5 //Identify the method that runs after the asynchronous search completes. 6 cons.SearchCompleted += new EventHandler<ContactsSearchEventArgs>(Contacts_SearchCompleted); 7 8 //Start the asynchronous search. 9 cons.SearchAsync(String.Empty, FilterKind.None, "Contacts Test #1"); 10 } 11 12 void Contacts_SearchCompleted(object sender, ContactsSearchEventArgs e) 13 { 14 //Do something with the results. 15 MessageBox.Show(e.Results.Count().ToString()); 16 }
联系人查询也需要创建联系人存储，创建联系人存储的形式和联系人新增是一样的。联系人查询是通过ContactStore的CreateContactQuery方法来创建一个查询，可以查询的参数ContactQueryOptions来设置查询返回的结果和排序的规则，创建的查询时ContactQueryResult类型。可以通过ContactQueryResult类的GetContactsAsync异步方法获取联系人存储中的联系人列表和通过GetCurrentQueryOptions方法获取当前的查询条件。
1 conStore = await ContactStore.CreateOrOpenAsync(); 2 ContactQueryResult conQueryResult = conStore.CreateContactQuery(); 3 uint count = await conQueryResult.GetContactCountAsync(); 4 IReadOnlyList<StoredContact> conList = await conQueryResult.GetContactsAsync();
1 // 查询联系人，并绑定到列表 2 async void Query() 3 { 4 ContactStore store = await ContactStore.CreateOrOpenAsync(); 5 ContactQueryResult result = store.CreateContactQuery(); 6 IReadOnlyList<StoredContact> contacts = await result.GetContactsAsync(); 7 8 listbox1.ItemsSource = contacts; 9 } 10 11 // 查询已知属性 12 async void GetPropertie(StoredContact contact) 13 { 14 IDictionary<string, object> props = await contact.GetPropertiesAsync(); 15 if (props.Keys.Contains(KnownContactProperties.Telephone)) 16 { 17 MessageBox.Show("手机：" + props[KnownContactProperties.Telephone].ToString()); 18 } 19 } 20 21 // 更新联系人 22 async Task Update(string Id) 23 { 24 try 25 { 26 ContactStore store = await ContactStore.CreateOrOpenAsync(); 27 var contact = await store.FindContactByIdAsync(Id); 28 if (contact != null) 29 { 30 contact.FamilyName = "某"; 31 contact.GivenName = "人"; 32 await contact.SaveAsync(); 33 } 34 } 35 catch (Exception e) 36 { 37 textblock1.Text = e.Message; 38 } 39 } 40 41 // 删除联系人 42 async private Task Delete(string Id) 43 { 44 try 45 { 46 ContactStore store = await ContactStore.CreateOrOpenAsync(); 47 await store.DeleteContactAsync(Id); 48 } 49 catch (Exception e) 50 { 51 textblock1.Text = e.Message; 52 } 53 } 54 55 // 新增 56 private async void Button_Click_1(object sender, RoutedEventArgs e) 57 { 58 string[] familyNames = new string[] { "郑", "钱", "郭", "罗", "贺" }; 59 string[] givenNames = new string[] {"家","航","燕","白","公" }; 60 Random r = new Random(); 61 62 await Add(familyNames[r.Next(0, familyNames.Length)], givenNames[r.Next(0, givenNames.Length)]); 63 Query(); 64 } 65 // 修改 66 private async void Button_Click_2(object sender, RoutedEventArgs e) 67 { 68 69 var contact= listbox1.SelectedValue as StoredContact; 70 if(null == contact) return; 71 await Update(contact.Id); 72 Query(); 73 } 74 75 // 删除 76 private async void Button_Click_3(object sender, RoutedEventArgs e) 77 { 78 var contact = listbox1.SelectedValue as StoredContact; 79 if(null == contact) return; 80 await Delete(contact.Id); 81 Query(); 82 } 83 84 // 查看手机号 85 private void Button_Click_4(object sender, RoutedEventArgs e) 86 { 87 var contact = listbox1.SelectedValue as StoredContact; 88 if(null == contact) return; 89 GetPropertie(contact); 90 }
