与众不同 windows phone (39) - 8.0 联系人和日历

2021-12-31 11:20:08

作者：webabcd

介绍
与众不同 windows phone 8.0 之联系人和日历

自定义联系人存储的增删改查
获取 Windows Phone 的联系人数据
获取 Windows Phone 的日历数据

示例
1、演示如何操作自定义联系人存储（自定义联系人的增删改查）
ContactsAndCalendar/CustomContacts.xaml

<phone:PhoneApplicationPage
    x:Class="Demo.ContactsAndCalendar.CustomContacts"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:phone="clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone"
    xmlns:shell="clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    FontFamily="{StaticResource PhoneFontFamilyNormal}"
    FontSize="{StaticResource PhoneFontSizeNormal}"
    Foreground="{StaticResource PhoneForegroundBrush}"
    SupportedOrientations="Portrait" Orientation="Portrait"
    mc:Ignorable="d"
    shell:SystemTray.IsVisible="True">
    
    <Grid Background="Transparent">
        <StackPanel Orientation="Vertical">

            <TextBlock x:Name="lblMsg" />

            <Button x:Name="btnAdd" Content="添加联系人" Click="btnAdd_Click" />

            <Button x:Name="btnUpdate" Content="更新联系人" Click="btnUpdate_Click" />

            <Button x:Name="btnDelete" Content="删除联系人" Click="btnDelete_Click" />

            <Button x:Name="btnQuery" Content="查询联系人" Click="btnQuery_Click" />

        </StackPanel>
    </Grid>
    
</phone:PhoneApplicationPage>

ContactsAndCalendar/CustomContacts.xaml.cs

/*
 * 演示如何操作自定义联系人存储（自定义联系人的增删改查）
 * 
 * 
 * ContactStore - 自定义联系人存储
 *     CreateOrOpenAsync(ContactStoreSystemAccessMode access, ContactStoreApplicationAccessMode sharing) - 创建或打开本 app 的自定义联系人存储
 *         ContactStoreSystemAccessMode - 操作系统对本 app 的自定义联系人存储的访问模式
 *             ReadOnly - 只能读
 *             ReadWrite - 除了读外，还可以修改
 *         ContactStoreApplicationAccessMode - 其他 app 对本 app 的自定义联系人存储的访问模式
 *             LimitedReadOnly - 只能读联系人的说明和显示图片
 *             ReadOnly - 可以读任何属性
 *     FindContactByIdAsync(), FindContactByRemoteIdAsync - 根据 Id 或 RemoteId 查找指定的联系人，返回 StoredContact 类型的对象
 *     DeleteContactAsync(), DeleteAsync() - 根据 Id 删除联系人，或者删除全部联系人
 *     CreateContactQuery(ContactQueryOptions options) - 创建一个联系人查询，返回 ContactQueryResult 类型的对象
 *         ContactQueryOptions - 查询参数
 *             DesiredFields - 需要返回的属性列表
 *             OrderBy - 排序字段（ContactQueryResultOrdering 枚举）
 *                 SystemDefault - 默认排序
 *                 GivenNameFamilyName - 先按名排序，再按姓排序
 *                 FamilyNameGivenName - 先按姓排序，再按名排序
 *     RevisionNumber - ContactStore 的修订号，只读
 *     GetChangesAsync(ulong baseRevisionNumber) - 返回与指定修订号关联的每次更改的 ContactChangeRecord 对象
 *     LoadExtendedPropertiesAsync() - 获取 ContactStore 的扩展属性集合
 *     SaveExtendedPropertiesAsync() - 保存 ContactStore 的扩展属性集合
 * 
 * StoredContact - 联系人对象
 *     FamilyName - 姓
 *     GivenName - 名
 *     HonorificPrefix - 前缀尊称
 *     HonorificSuffix - 后缀尊称
 *     DisplayName - 显示名称
 *     DisplayPicture - 显示图片
 *     Id - 联系人的本地标识（只读）
 *     RemoteId - 联系人的远程标识，应确保其在手机上的所有应用中都是唯一的
 *     Store - 对应的 ContactStore 对象
 *     KnownContactProperties() - 异步方式获取显示图片
 *     SetDisplayPictureAsync() - 异步方式设置显示图片
 *     GetPropertiesAsync() - 获取已知属性（key 的值为 Windows.Phone.PersonalInformation.KnownContactProperties 类中的字段）
 *     GetExtendedPropertiesAsync() - 获取扩展属性（key 的值任意）
 *     SaveAsync() - 保存当前联系人信息
 *     ReplaceExistingContactAsync(string id) - 使用当前联系人替换指定 Id 的联系人
 *     
 * ContactQueryResult - 联系人查询结果对象
 *     GetContactsAsync() - 获取全部联系人
 *     GetContactsAsync(uint startIndex, uint maxNumberOfItems) - 获取指定范围的联系人
 *     GetContactCountAsync() - 获取当前查询的联系人总数
 *     GetCurrentQueryOptions() - 获取对应的 ContactQueryOptions，参见 CreateContactQuery(ContactQueryOptions options)
 * 
 * 
 * 注：
 * 1、需要在 mainfest 中增加 <Capability Name="ID_CAP_CONTACTS" />
 * 2、Id 代表联系人的本地标识（只读）
 * 3、RemoteId 代表联系人的远程标识，应确保其在手机上的所有应用中都是唯一的
 */

using System;
using System.Collections.Generic;
using System.Windows;
using Microsoft.Phone.Controls;
using Windows.Phone.PersonalInformation;

namespace Demo.ContactsAndCalendar
{
    public partial class CustomContacts : PhoneApplicationPage
    {
        private Random _random = new Random();

        public CustomContacts()
        {
            InitializeComponent();
        }

        // 添加联系人
        private async void btnAdd_Click(object sender, RoutedEventArgs e)
        {
            ContactStore contactStore = await ContactStore.CreateOrOpenAsync();

            StoredContact storedContact = new StoredContact(contactStore);

            storedContact.RemoteId = Guid.Empty.ToString();

            storedContact.GivenName = _random.Next(1000, 10000).ToString();
            storedContact.FamilyName = "wang";

            // 设置已知属性
            IDictionary<string, object> props = await storedContact.GetPropertiesAsync();
            props.Add(KnownContactProperties.Email, "xxx@xxx.xxx");

            // 设置扩展属性
            IDictionary<string, object> extprops = await storedContact.GetExtendedPropertiesAsync();
            extprops.Add("ext1", "ext1");

            // 保存当前联系人
            await storedContact.SaveAsync();
        }

        // 更新联系人
        private async void btnUpdate_Click(object sender, RoutedEventArgs e)
        {
            ContactStore contactStore = await ContactStore.CreateOrOpenAsync();

            string remoteId = Guid.Empty.ToString();
            StoredContact storedContact = await contactStore.FindContactByRemoteIdAsync(remoteId);

            if (storedContact != null)
            {
                storedContact.GivenName = _random.Next(1000, 10000).ToString();
                storedContact.FamilyName = "wang";

                // 设置已知属性
                IDictionary<string, object> props = await storedContact.GetPropertiesAsync();
                props[KnownContactProperties.Email] = "xxx@xxx.xxx";

                // 设置扩展属性
                IDictionary<string, object> extprops = await storedContact.GetExtendedPropertiesAsync();
                extprops["ext1"] = "ext1";

                // 保存当前联系人
                await storedContact.SaveAsync();
            }
        }

        // 删除联系人
        private async void btnDelete_Click(object sender, RoutedEventArgs e)
        {
            ContactStore contactStore = await ContactStore.CreateOrOpenAsync();

            string remoteId = Guid.Empty.ToString();
            StoredContact storedContact = await contactStore.FindContactByRemoteIdAsync(remoteId);

            // 根据本地标识删除联系人
            await contactStore.DeleteContactAsync(storedContact.Id);
        }

        // 查询联系人
        private async void btnQuery_Click(object sender, RoutedEventArgs e)
        {
            ContactStore contactStore = await ContactStore.CreateOrOpenAsync();
            ContactQueryResult result = contactStore.CreateContactQuery();
            IReadOnlyList<StoredContact> storedContacts = await result.GetContactsAsync();

            lblMsg.Text = "本 app 的自定义联系人总数: " + storedContacts.Count.ToString();
        }      
    }
}

2、演示如何获取 Windows Phone 的联系人数据
ContactsAndCalendar/AccessContacts.xaml

<phone:PhoneApplicationPage
    x:Class="Demo.ContactsAndCalendar.AccessContacts"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:phone="clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone"
    xmlns:shell="clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    FontFamily="{StaticResource PhoneFontFamilyNormal}"
    FontSize="{StaticResource PhoneFontSizeNormal}"
    Foreground="{StaticResource PhoneForegroundBrush}"
    SupportedOrientations="Portrait" Orientation="Portrait"
    mc:Ignorable="d"
    shell:SystemTray.IsVisible="True">

    <Grid Background="Transparent">
        <StackPanel Orientation="Vertical">

            <TextBlock x:Name="lblMsg" />
            
            <Image Name="img" Width="100" Height="100" />
            <Image Name="img2" Width="100" Height="100" Margin="0 10 0 0" />
            
            <Button x:Name="btnGet" Content="获取联系人数据" Click="btnGet_Click" />

        </StackPanel>
    </Grid>

</phone:PhoneApplicationPage>

ContactsAndCalendar/AccessContacts.xaml.cs

/*
 * 演示如何获取 Windows Phone 的联系人数据
 * 
 * 
 * 注：
 * 1、需要在 mainfest 中增加 <Capability Name="ID_CAP_CONTACTS" />
 * 2、获取联系人数据之前，应提供隐私策略并得到用户的允许。参见：http://msdn.microsoft.com/zh-cn/library/windowsphone/develop/hh184841(v=vs.105).aspx 的 2.11
 * 3、关于获取联系人和日历数据请参见：http://www.cnblogs.com/webabcd/archive/2012/08/29/2661418.html
 */

using System;
using System.Linq;
using System.Windows;
using Microsoft.Phone.Controls;
using Microsoft.Phone.UserData;
using System.Collections.Generic;
using System.Windows.Media.Imaging;

namespace Demo.ContactsAndCalendar
{
    public partial class AccessContacts : PhoneApplicationPage
    {
        public AccessContacts()
        {
            InitializeComponent();
        }

        private void btnGet_Click(object sender, RoutedEventArgs e)
        {
            // Contacts - 用于获取联系人数据
            Contacts contacts = new Contacts();

            // Contacts.SearchCompleted - 当搜索联系人数据完成时所触发的事件
            contacts.SearchCompleted += contacts_SearchCompleted;

            /*
             * Contacts.SearchAsync(string filter, FilterKind filterKind, object state) - 按指定参数搜索联系人
             *     string filter - 搜索关键字
             *     FilterKind filterKind - 搜索范围
             *         None - 全部联系人
             *         PinnedToStart - 在固定到开始屏幕的联系人中搜索
             *         EmailAddress - 按电子邮件地址搜索
             *         PhoneNumber - 按电话号码搜索
             *         DisplayName - 按显示名称搜索
             *         Identifier - 按本地标识搜索
             *     object state - 异步处理的上下文对象
             */
            contacts.SearchAsync(string.Empty, FilterKind.None, null);
        }

        void contacts_SearchCompleted(object sender, ContactsSearchEventArgs e)
        {
            /*
             * ContactsSearchEventArgs - 事件参数
             *     Filter, FilterKind, State - 对应 Contacts.SearchAsync() 方法中的参数
             *     Results - 搜索结果
             * 
             * Contact - 某个联系人的相关信息
             *     详细说明见文档，以下就部分属性和方法做说明
             */
            IEnumerable<Contact> contacts = e.Results;

            lblMsg.Text = "联系人数量：" + contacts.Count().ToString();
            lblMsg.Text += Environment.NewLine;

            lblMsg.Text += "第一个联系人的所属数据源数量：" + contacts.First().Accounts.Count();
            lblMsg.Text += Environment.NewLine;

            // StorageKind 枚举：Phone, WindowsLive, Outlook, Facebook, Other（自定义联系人存储属于 Other）
            lblMsg.Text += "第一个联系人的所属的第一个数据源：" + contacts.First().Accounts.First().Kind.ToString();
            lblMsg.Text += Environment.NewLine;

            lblMsg.Text += "第一个联系人的显示名称：" + contacts.First().DisplayName;
            lblMsg.Text += Environment.NewLine;

            // 第一个联系人的照片
            BitmapImage bitmapImage = new BitmapImage();
            bitmapImage.SetSource(contacts.First().GetPicture());
            img.Source = bitmapImage; // 第一种显示 Stream 图片的方法

            img2.Source = Microsoft.Phone.PictureDecoder.DecodeJpeg(contacts.First().GetPicture()); // 第二种显示 Stream 图片的方法
        }
    }
}

3、演示如何获取 Windows Phone 的日历数据
ContactsAndCalendar/AccessCalendar.xaml

<phone:PhoneApplicationPage
    x:Class="Demo.ContactsAndCalendar.AccessCalendar"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:phone="clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone"
    xmlns:shell="clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    FontFamily="{StaticResource PhoneFontFamilyNormal}"
    FontSize="{StaticResource PhoneFontSizeNormal}"
    Foreground="{StaticResource PhoneForegroundBrush}"
    SupportedOrientations="Portrait" Orientation="Portrait"
    mc:Ignorable="d"
    shell:SystemTray.IsVisible="True">

    <Grid Background="Transparent">
        <StackPanel Orientation="Vertical">

            <TextBlock x:Name="lblMsg" />

            <Button x:Name="btnGet" Content="获取日历数据" Click="btnGet_Click" />

        </StackPanel>
    </Grid>

</phone:PhoneApplicationPage>

ContactsAndCalendar/AccessCalendar.xaml.cs

/*
 * 演示如何获取 Windows Phone 的日历数据
 * 
 * 
 * 注：
 * 1、需要在 mainfest 中增加 <Capability Name="ID_CAP_APPOINTMENTS" />
 * 2、获取日历数据之前，应提供隐私策略并得到用户的允许。参见：http://msdn.microsoft.com/zh-cn/library/windowsphone/develop/hh184841(v=vs.105).aspx 的 2.11
 * 3、关于获取联系人和日历数据请参见：http://www.cnblogs.com/webabcd/archive/2012/08/29/2661418.html
 */

using System;
using System.Linq;
using System.Windows;
using Microsoft.Phone.Controls;
using Microsoft.Phone.UserData;
using System.Collections.Generic;

namespace Demo.ContactsAndCalendar
{
    public partial class AccessCalendar : PhoneApplicationPage
    {
        public AccessCalendar()
        {
            InitializeComponent();
        }

        private void btnGet_Click(object sender, RoutedEventArgs e)
        {
            // Appointments - 用于获取日历数据
            Appointments appointments = new Appointments();

            // Appointments.SearchCompleted - 当搜索日历数据完成时所触发的事件
            appointments.SearchCompleted += appointments_SearchCompleted;

            DateTime start = DateTime.Now;
            DateTime end = start.AddDays(7);
            int max = 20;

            /*
             * Appointments.SearchAsync(DateTime startTimeInclusive, DateTime endTimeInclusive, int maximumItems, Account account, object state) - 按指定参数搜索日历数据
             *     DateTime startTimeInclusive - 约会的开始时间
             *     DateTime endTimeInclusive - 约会的结束时间
             *     int maximumItems - 返回约会的最大数量
             *     Account account - 要搜索的约会的数据源
             *     object state - 异步处理的上下文对象
             */
            appointments.SearchAsync(start, end, max, "Appointments Test #1");
        }

        void appointments_SearchCompleted(object sender, AppointmentsSearchEventArgs e)
        {
            /*
             * AppointmentsSearchEventArgs - 事件参数
             *     StartTimeInclusive, EndTimeInclusive, State - 对应 Appointments.SearchAsync() 方法中的参数
             *     Results - 搜索结果
             * 
             * Appointment - 某个约会的相关信息
             *     详细说明见文档，以下就部分属性和方法做说明
             */
            IEnumerable<Appointment> appointments = e.Results;

            lblMsg.Text = "获取到的约会数量：" + appointments.Count().ToString();
            lblMsg.Text += Environment.NewLine;

            lblMsg.Text += "第一个约会所属数据源的账户名称：" + appointments.First().Account.Name;
            lblMsg.Text += Environment.NewLine;

            // StorageKind 枚举：Phone, WindowsLive, Outlook, Facebook, Other
            lblMsg.Text += "第一个约会所属数据源的种类：" + appointments.First().Account.Kind.ToString();
            lblMsg.Text += Environment.NewLine;

            lblMsg.Text += "第一个约会的主题：" + appointments.First().Subject;
            lblMsg.Text += Environment.NewLine;
        }
    }
}

OK
[源码下载]

码农公寓

相关文章