Windows Phone 8 程序联系人存储.doc

Windows Phone 8 程序联系人存储 程序联系人存储是第三方的应用程序创建的联系人数据，这些联系人的数据也可以在手机的通讯录里面进行显示，但是它们是由创建这些联系人数据的第三方应用程序所管理的。联系人数据的归属应用程序可以设置这些联系人数据的系统和其他程序的访问权限，对属于它自己的联系人具有增删改的权限，并且一旦用户卸载了联系人数据归属应用程序，这些联系人也会被删除掉。程序联系人存储的API在空间Windows.Phone.PersonalInformation下，下面来看一下如何去使用这些API来操作联系人。 ContactStore类和StoredContact类 ContactStore类表示一个Windows Phone应用程序的自定义联系人存储，它是应用程序存储的一个管理者，负责管理应用程序所创建的联系人。ContactStore类的主要成员如表15.9所示。StoredContact类表示一个应用程序自定义的联系人存储，它继承了IContactInformation接口，所有由应用程序创建的联系人都是一个StoredContact类的对象。StoredContact类的主要成员如表15.10所示。 表15.9 ContactStore类的主要成员 成员 说明 public ulong RevisionNumber { get; } 联系人存储的版本号 public ContactQueryResult CreateContactQuery() 创建一个默认的联系人查询，返回ContactQueryResult对象，包含了存储中的联系人 public ContactQueryResult CreateContactQuery(ContactQueryOptions options) 创建一个自定义的联系人查询，返回ContactQueryResult对象，包含了存储中的联系人 public static IAsyncOperationContactStore CreateOrOpenAsync() 异步方法创建或者打开应用程序的自定义联系人存储，假如存储不存在将创建一个存储 public static IAsyncOperationContactStore CreateOrOpenAsync(ContactStoreSystemAccessMode access, ContactStoreApplicationAccessMode sharing) 异步方法创建或者打开应用程序的自定义联系人存储，假如存储不存在将创建一个存储，返回当前的联系人存储对象 access:联系人是否可以在手机系统通讯录里面进行编辑还是只能在应用程序中创建 sharing:是否存储的联系人所有属性都可以在另外的应用程序里面进行访问 public IAsyncAction DeleteAsync() 异步方法删除应用程序的联系人存储 public IAsyncAction DeleteContactAsync(string id) 异步方法通过联系人的ID删除应用程序里面存储的联系人 public IAsyncOperationStoredContact FindContactByIdAsync(string id) 异步方法通过ID查找应用程序的联系人，返回StoredContact对象 public IAsyncOperationStoredContact FindContactByRemoteIdAsync(string id) 异步方法通过remote ID查找应用程序的联系人，返回StoredContact对象 public IAsyncOperationIReadOnlyListContactChangeRecord GetChangesAsync(ulong baseREvisionNumber) 异步方法通过联系人的版本号获取联系人改动记录 public IAsyncOperationIDictionarystring, object LoadExtendedPropertiesAsync() 异步方法加载应用程序联系人的扩展属性Map表 public IAsyncAction SaveExtendedPropertiesAsync(IReadOnlyDictionarystring, object data) 异步方法保存应用程序联系人的扩展属性Map表 表15.10 StoredContact类的主要成员 成员 说明 public StoredContact(ContactStore store) 通过当前应用程序的ContactStore来初始化一个StoredContact对象 p