正文

Windows Phone 8 - 建立App专属联络人资讯(ContactStore)

IP云
IP云V管理员/7 阅读
11/25
提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

原文:Windows Phone 8 - 建立App专属联络人资讯(ContactStore)

在WP7的时候介绍了如何操作联络人的功能，例如：<Windows Phone 7 - 存取联络人与行事历资料>。

到了WP8之後增加了一个非常不一样的联络人相关的API：ContactStore，也是该篇文章要介绍的主题。

?

什麽是 ContactStore ？

?提供让App可以建立自己专属的Contact Store(联络人储存区)；

?系统会自动将建立好的Contact Store整合入People Hub中。

?除了在App操作既有的Contact集合的资讯(例如：Windows Live、Facebook…等)，

?? 也可以增加自订的Custom Properties加以扩充；

??? => 需注意自订的Custom Properties需储存於Contact Store中；

??? => 并不会显示在People Hub的Contact Card上，而是需要透过App加以程序化操作；

?ContactStore API提供让App自订义的Contact store可与现有Contact Store加以同步与比对变化；

?

[ 注意 ]

?每一个App只能有一个Contact Store；

?App建立Contact Store後，系统在整合入People Hub时，可能会造成People Hub在使用上会有lag的状况；

?? => 不用担心，等系统整合完毕後该问题即不存在。

?App建立的contact Store自动整合入People Hub，如果不想让People Hub看起来很混乱；

?? => 可至「设定->应用程式->联络人->筛选我的联络人清单」，取消勾选该App的资源来源。

?

可以利用下图来说明ContactStore与系统、其他应用程式的关系：

一个App可以建立一个专属的ContactStore，并且设定该ContactStore被系统或其他Apps存取的权限，

在操作透过StoredContact物件为单位；App经由Cloud Data Source取得最新的资讯并同步至既有的StoredContact里，

而同步的方式则是依赖StoredContact.RemoteId的属性来维持一致性，所以每一个RemoteId必需是unique的。

?

?

往下便加以针对ContactStore的相关命名空间与类别加以说明：

?

〉 Windows.Phone.PersonalInformation namespace ：

??? 主要提供APIs负责管理自订的contact store。透过下表来概要说明具有的元素：

类型 名称 说明
Class ContactAddress Represents a civic address for StoredContact objects.
? ContactChangeRecord Represents a change in contact information that occurred between revisions.
? ContactInformation Represents a contact without an association to a contact store .
? ContactQueryOptions Represents query options for retrieving contacts using CreateContactQuery.
? ContactQueryResult Represents the result of a contact query.

在建立ContactQueryResult可搭配ContactQueryOptions指定查询的条件与排序的方式。

重要的方法：
?GetContactCountAsync??? Gets the number of contacts in the contact store.

?GetContactsAsync()
??? Retrieves contacts from the contact store.

?GetContactsAsync(UInt32, UInt32)??? Retrieves contacts from the contact store given the specified starting index and
??? number of items to return .
?
?GetCurrentQueryOptions??? Gets the current query options.
? ContactStore Represents the custom contact store for a Windows Phone app.
? KnownContactProperties Provides key names for accessing known properties for StoredContact or ContactInformation objects .
? StoredContact Represents a contact associated with a custom contact store.
Enumerations ContactChangeType Indicates the type of change represented by a ContactChangeRecord .
? ContactQueryResultOrdering The order in which contacts are returned from CreateContactQuery .
? ContactStoreApplicationAccessMode Specifies the application access mode for a custom contact store created with CreateOrOpenAsync .
? ContactStoreSystemAccessMode Specifies the system access mode for a custom contact store created with CreateOrOpenAsync .
? VCardFormat The format of a vCard.
Interface IContactInformation Defines the interface for contact information.

在使该用该Namepsace下的元素时要，要记得开启对应的<Capabilities />：「 ID_CAP_CONTACTS 」。

?

上述大致上列出该Namesapce具有的元素，往下一一针对如何操作ContactStore与使用StoredContact来加以说明。

?

〉 ContactStroe ：

??? 为代表每一个App专属的custom contact store。搭配CreateOrOpenAsync()建立或开启contact store，搭配StoredContact物件加以

操作该contact store里的资料。往下说明可用的方法与使用方式：

类型 名称 说明
Property RevisionNumber Read-only。取得contact store的版本号。
Method CreateContactQuery() 使用预设的查询选项建立一个contact query已取得ContactQueryResult。
? CreateContactQuery(ContactQueryOptions) 使用自订的查询选项建立一个contact query已取得ContactQueryResult。
?ContactQueryOptions：
??? 用於指定contact query的查询选项，具有二个属性可以使用：
??? > DesiredField：ready-only，设定/取得查询结果的contact要显示的属性清单；
??? > OrderBy：设定/取得查询结果的contact要用那一个栏位进行排序；
? CreateOrOpenAsync() 开启App专属的custom contact store，如果该store不存在预设会自动建立一个。
? CreateOrOpenAsync(ContactStoreSystemAccessMode, ContactStoreApplicationAccessMode) 开启App专属的custom contact store，如果该store不存在预设会自动建立一个。
搭配ContactStoreSystemAccessMode与ContactStoreApplicationAccessMode来指定contact store被存取的权限，说明如下：

?ContactStoreSystemAccessMode：

?? 指定系统本身操作该contact store的方式：

?? > ReadOnly：系统仅能读取该contact store；

?? > ReadWrite：系统可以修改该contact store中的contacts；

????????????????????? (through its built-in contacts experience.)

?ContactStoreApplicationAccessMode：

?? 指定其他应用程式可以操作该contact store的方式：

?? > LimitedReadOnly：只能读取store中contacts的description、display picture；

?? > ReadOnly：可以读取所有store中contacts的属性；

?

预设指定为：ContactStoreSystemAccessMode.ReadOnly与ContactStoreApplicationAccessMode.LimitedReadOnly；

? DeleteAsync 删除custom contact store。
? DeleteContactAsync 删除custom contact store中指定contact ID的Contact。
? FindContactByIdAsync 检索custom contact store中指定contact ID的Contacts，取得IAsyncOperation<StoredContact> 的集合。
? FindContactByRemoteIdAsync 检索custom contact store中指定contact remote ID的Contacts，取得IAsyncOperation<StoredContact> 的集合。
? GetChangesAsync 获取变更与所提供的版本号相关联的联系人存储的列表。
回传值为：IAsyncOperation<IVectorView>。
? LoadExtendedPropertiesAsync 为custom contact store载入扩充的属性集合。
回传值：IAsyncOperation<IDictionary>。
该方法被用於针对contact store载入扩充的属性，而不是针对个别的contact。

常见情境即是用於有的contact store加入延伸的属性，利用revision number来与remote contact store进行同步，取得extension properties来加入既有的contact store。
? SaveExtendedPropertiesAsync 储存新提供的name/value清单至custom contact store的扩充属性。
SaveExtendedPropertiesAsync( IReadOnlyDictionary<String, Object> data ) 。

???

?

〉 StoredContact ：

??? 代表关联於custom contact store的contact物件。相关的建构子、方法与属性说明如下：

类型 名称 说明
Constructor StoredContact(ContactStore) 初始化StoredContact类别的实体。
? StoredContact(ContactStore, ContactInformation) 初始化StoredContact类别的实体，并给予具有初始化相关属性的ContactInformation物件。
Method GetDisplayPictureAsync 取得stored contact的显示图像。
? GetExtendedPropertiesAsync 取得stored contact的扩充属性集合，采用name/value pairs呈现。
? GetPropertiesAsync 取得contact已知的属性集合。
? ReplaceExistingContactAsync 利用目前的StoredContact取代指定ID的contact。
? SaveAsync 储存目前StoedContact的状态与属性至contact store。
? SetDisplayPictureAsync 使用IInputStream object设定contact的显示图像。
? ToVcardAsync() 采用vCard 3.0 format来将contact加以表示。
? ToVcardAsync(VCardFormat) 采用特定vCard format来将contact加以表示。
Property DisplayName Read/write。设定/取得stored contact的显示名称。
? DisplayPicture Read-only。取得stored contact的显示图像。
? FamilyName Read/write。设定/取得stored contact的家庭名称。
? GivenName Read/write。设定/取得stored contact的特定名称。
? HonorificPrefix Read/write。设定/取得stored contact的honorific prefix(敬语前缀)。
? HonorificSuffix Read/write。设定/取得stored contact的honorific suffix(敬语後缀)。
? Id Read-only。取得stored contact的local identifier(该值由系统自动给予)。
? RemoteId Read/write。设定/取得stored contact的remote identifier。
? Store Read-only。取得stored contact所储存的ContactStore。其值在StoredContact建构子时就会被给予。

要使用StoredContact时预先要取得ContactStore，另外StoredContact是利用 local id(来自系统给予)与 remote id来加以管理，

利用remote + local id来建立关联电话中的contact与cloud上的contact；所以App里如果要管理自订义的Contact可给予唯一的

RemoteId来予後端的系统资料加以对应。

如果要操作的联络人资讯未被储存於ContactStore或StoredContact，可藉由ContactInformation加以描述来使用。

?

?

以上说明完重要的类别与方法後，往下便藉由范例的方式来说明如何加以运用。

?

[ 范例 ]

该范例的情境，例如：

a. 做一个App专属於某家公司的零件维修人员专用；

b. App自动会建立专属的联络人，用户不需要手动建立；

c. 专属联络人的资料由後端系统维护；

?

了解该范例的情境後，以下分成几个步骤来加以介绍操作的方式：

?

A. 建立後端联络人资料档案(以XML档为例)，负责管理StoredContact.RemoteId； 

<?xml version="1.0" encoding="utf-8" ?>

CRLF 

<contacts version="1">

CRLF 

  <contact rid="10000" dname="jenna" fname="wang" gname="jenna" prefix="" suffix="">

CRLF 

    <picture>https://fbcdn-sphotos-f-a.akamaihd.net/hphotos-ak-prn1/t1/75603_10153754407645367_493094653_n.jpg?dl=1</picture>

CRLF 

    <mphone>0932111222</mphone>

CRLF 

    <mail>jenna@live.com</mail>

CRLF 

    <jobtitle>Actor</jobtitle>

CRLF 

  </contact>

CRLF 

  <contact rid="10001" dname="安心亚" fname="" gname="" prefix="" suffix="">

CRLF 

    <picture>https://fbcdn-sphotos-e-a.akamaihd.net/hphotos-ak-prn2/t1/1502517_10153643531660467_768374391_n.jpg?dl=1</picture>

CRLF 

    <mphone>0932111222</mphone>

CRLF 

    <mail>annie@live.com</mail>

CRLF 

    <jobtitle>Actor</jobtitle>

CRLF 

  </contact>

CRLF 

  <contact rid="10002" dname="Zooey Deschanel" fname="Deschanel" gname="" prefix="" suffix="">

CRLF 

    <picture>http://images.artistdirect.com/Images/nad/video/tribune/65426/65426_bc.jpg</picture>

CRLF 

    <mphone>0932111123</mphone>

CRLF 

    <mail>zooey@live.com</mail>

CRLF 

    <jobtitle>Actor</jobtitle>

CRLF 

  </contact>

CRLF 

  <contact rid="10003" dname="Natalie Portman" fname="" gname="" prefix="" suffix="">

CRLF 

    <picture>http://beauty.nownews.com/img/27/i26127-24.jpg</picture>

CRLF 

    <mphone>0932147699</mphone>

CRLF 

    <mail>portman@live.com</mail>

CRLF 

    <jobtitle>Actor</jobtitle>

CRLF 

  </contact>

CRLF 

</contacts>

CRLF

??? 以上是使用XML的方式建立了联络人的资讯，当然如果具有自行管理的联络人系统就可以不用这样麻烦。

??? 该范例把建立好的XML档放置至於网路空间：Skydrvie或Dropbox均可以。

?

?

B. 建立一个画面专门用於同步与汇入远端联络人资料档；

??? b-1. XAML： 

<!--TitlePanel contains the name of the application and page title-->

CRLF 

<StackPanel x:Name="TitlePanel" Grid.Row="0" Margin="12,17,0,28">

CRLF 

    <TextBlock Text="ContactStore Project" Style="{StaticResource PhoneTextNormalStyle}" Margin="12,0"/>

CRLF 

    <TextBlock Text="同步" Margin="9,-7,0,0" Style="{StaticResource PhoneTextTitle1Style}"/>

CRLF 

</StackPanel>

CRLF 

?

CRLF 

<!--ContentPanel - place additional content here-->

CRLF 

<Grid x:Name="ContentPanel" Grid.Row="1" Margin="12,0,12,0">

CRLF 

    <StackPanel>

CRLF 

        <Button Content="点击同步" Click="Button_Click" />

CRLF 

        <TextBlock x:Name="tblTile" Text="同步状态" Margin="15,5,5,10" />

CRLF 

        <toolkit:WrapPanel Width="450" Height="300">

CRLF 

            <TextBlock TextWrapping="Wrap"

CRLF 

                       x:Name="tblResultMsg"

CRLF 

                       Width="440" Height="300"

CRLF 

                       Margin="5"  />

CRLF 

        </toolkit:WrapPanel>

CRLF 

        <Button Content="操作Contact Store" Click="Button_Click_1" />

CRLF 

    </StackPanel>

CRLF 

</Grid>

CRLF

?

???? b-2. 在OnNavigationTo初始化ContactStore物件； 

private ContactStore gMyCStore = null;

CRLF 

?

CRLF 

protected async override void OnNavigatedTo(NavigationEventArgs e)

CRLF 

{

CRLF 

    base.OnNavigatedTo(e);

CRLF 

?

CRLF 

    // 进行必要元件的初始化

CRLF 

    if (gMyCStore == null)

CRLF 

    {

CRLF 

        gMyCStore = await ContactStore.CreateOrOpenAsync();

CRLF 

        // 可搭配对应的AsscessMode来初始化ContactStore。

CRLF 

        //gMyCStore = await ContactStore.CreateOrOpenAsync(

CRLF 

        //                        ContactStoreSystemAccessMode.ReadWrite,

CRLF 

        //                        ContactStoreApplicationAccessMode.ReadOnly);

CRLF 

    }

CRLF 

}

CRLF

?

???? b-3. 建立按钮事件来触发 下载联络人资料档案的任务； 

private void Button_Click(object sender, RoutedEventArgs e)

CRLF 

{

CRLF 

    // 下载远端的联络人资料档案

CRLF 

    string tURL = "";

CRLF 

?

CRLF 

    HttpWebRequest tRequest = HttpWebRequest.CreateHttp(tURL);

CRLF 

    tRequest.BeginGetResponse((IAsyncResult ar) =>

CRLF 

    {

CRLF 

        if (ar.IsCompleted)

CRLF 

        {

CRLF 

            HttpWebResponse tResponse =

CRLF 

                (HttpWebResponse)tRequest.EndGetResponse(ar);

CRLF 

            if (tResponse.StatusCode == HttpStatusCode.OK)

CRLF 

            {

CRLF 

                using (StreamReader tResponseStream =

CRLF 

                        new StreamReader(tResponse.GetResponseStream()))

CRLF 

                {

CRLF 

                    string strResult = tResponseStream.ReadToEnd();

CRLF 

                    XDocument tXDoc = XDocument.Parse(strResult);

CRLF 

?

CRLF 

                    // 识别是否需要进行更新

CRLF 

                       bool tIsNeedUpdate = true;

CRLF 

                    if (IsolatedStorageSettings.ApplicationSettings.Contains("cs_v") == true)

CRLF 

                    {

CRLF 

                        double tV = double.Parse(

CRLF 

                                IsolatedStorageSettings.ApplicationSettings["cs_v"].ToString());

CRLF 

                        var tNVersoin = double.Parse(tXDoc.Root.Attribute("version").Value);

CRLF 

                        if (tNVersoin <= tV) tIsNeedUpdate = false;

CRLF 

                    }

CRLF 

                    if (tIsNeedUpdate)

CRLF 

                    {

CRLF 

                        // 进行更新

CRLF 

                        FeedDataToContactStore(tXDoc);

CRLF 

                    }

CRLF 

                }

CRLF 

            }

CRLF 

        }

CRLF 

    }, tRequest);

CRLF 

}

CRLF

??????????? 上述程式除了完成下载联络人资料档之外，也做了版本的比对，这样一来只要管理後端的资料档，

??????????? 等用户按下同步，App就可以取得最新的资料档案进行更新了。

?

???? b-4. 负责汇入联络人资料至ContactStore； 

/// <summary>

CRLF 

/// 将远端联络人资讯更新至本地的ContactStore。

CRLF 

/// </summary>

CRLF 

/// <param name="pXDoc"></param>

CRLF 

private async void FeedDataToContactStore(XDocument pXDoc)

CRLF 

{

CRLF 

    try

CRLF 

    {

CRLF 

        var tDataSet = from CItem in pXDoc.Descendants().Elements("contact")

CRLF 

                        select CItem;

CRLF 

        // 遂一更新既有的联络人

CRLF 

        foreach (XElement tCItem in tDataSet)

CRLF 

        {

CRLF 

            StoredContact tCObj = null;

CRLF 

            // 先识别指定的Id是否已经存在了，才不会重覆加入StoredContact

CRLF 

            tCObj = await gMyCStore.FindContactByRemoteIdAsync(tCItem.Attribute("rid").Value);

CRLF 

            if (tCObj == null)

CRLF 

            {

CRLF 

                // 代表指定的RemoteId不存在於custom ContactStore

CRLF 

                tCObj = new StoredContact(gMyCStore);

CRLF 

                tCObj.RemoteId = tCItem.Attribute("rid").Value;

CRLF 

            }

CRLF

CRLF 

            // 填入必要的参数

CRLF 

            tCObj.DisplayName = tCItem.Attribute("dname").Value;

CRLF 

            tCObj.FamilyName = tCItem.Attribute("fname").Value;

CRLF 

            tCObj.GivenName = tCItem.Attribute("gname").Value;

CRLF 

            tCObj.HonorificPrefix = tCItem.Attribute("prefix").Value;

CRLF 

            tCObj.HonorificSuffix = tCItem.Attribute("suffix").Value;

CRLF 

?

CRLF 

            // 利用GetPropertiesAsync填入已知的联络人资讯

CRLF 

            IDictionary<string, object> props = await tCObj.GetPropertiesAsync();

CRLF 

            if (props.ContainsKey(KnownContactProperties.Email))

CRLF 

                props[KnownContactProperties.Email] = tCItem.Element("mail").Value;

CRLF 

            else

CRLF 

                props.Add(KnownContactProperties.Email, tCItem.Element("mail").Value);

CRLF 

            if (props.ContainsKey(KnownContactProperties.MobileTelephone))

CRLF 

                props[KnownContactProperties.MobileTelephone] = tCItem.Element("mphone").Value;

CRLF 

            else

CRLF 

                props.Add(KnownContactProperties.MobileTelephone, tCItem.Element("mphone").Value);

CRLF 

            if (props.ContainsKey(KnownContactProperties.JobTitle))

CRLF 

                props[KnownContactProperties.JobTitle] = tCItem.Element("jobtitle").Value;

CRLF 

            else

CRLF 

                props.Add(KnownContactProperties.JobTitle, tCItem.Element("jobtitle").Value);

CRLF 

?

CRLF 

            // 增加扩充的属性描述

CRLF 

            IDictionary<string, object> extprops = await tCObj.GetExtendedPropertiesAsync();

CRLF 

            if (extprops.ContainsKey("Provider") == false)

CRLF 

                extprops.Add("Provider", "Pou Mason - ContactStoreProj");

CRLF 

?

CRLF 

            // 填入呈现的图像

CRLF 

            try

CRLF 

            {

CRLF 

                HttpWebRequest tRequest = HttpWebRequest.CreateHttp(tCItem.Element("picture").Value);

CRLF 

                tRequest.BeginGetResponse(async (IAsyncResult ar) =>

CRLF 

                {

CRLF 

                    if (ar.IsCompleted)

CRLF 

                    {

CRLF 

                        HttpWebResponse tResponse = (HttpWebResponse)tRequest.EndGetResponse(ar);

CRLF 

                        if (tResponse.StatusCode == HttpStatusCode.OK)

CRLF 

                        {

CRLF 

                            await tCObj.SetDisplayPictureAsync(tResponse.GetResponseStream().AsInputStream());

CRLF 

                            // 由於是不同的thread，所以要再使用一次SaveAsync()

CRLF 

                            await tCObj.SaveAsync();

CRLF 

                        }

CRLF 

                    }

CRLF 

                }, tRequest);

CRLF 

            }

CRLF 

            catch (Exception) { }

CRLF 

?

CRLF 

            // 储存至ContactStore

CRLF 

            await tCObj.SaveAsync();

CRLF 

?

CRLF 

            // 更新进度

CRLF 

            Dispatcher.BeginInvoke(() =>

CRLF 

            {

CRLF 

                tblTile.Text += string.Format("\nname: {0}, \t{1}", tCObj.DisplayName, "success");

CRLF 

            });

CRLF 

        }

CRLF 

    }

CRLF 

    catch (Exception ex)

CRLF 

    {

CRLF 

        Dispatcher.BeginInvoke(() =>

CRLF 

        {

CRLF 

            tblTile.Text += ex.Message;

CRLF 

        });

CRLF 

    }

CRLF 

}

CRLF

??????????? 上述程式根据取得的XML资料加以汇入至ContactStore，每一个<contact />搭配一个rid的唯一值来对应ContactStore

??????????? 中的StoredContact物件，加以识别是否具有存在的Properties与ExtendedProperties，并采用非同步设定它的DisplayPicture。

?

??????????? [ 注意 ]

??????????? a. 里面使用了HttpWebRequest的并没有做最佳化的处理，所以当大量资料汇入时可能会有问题。

??????????? b. 采用非同步下载图像资料时，由於与汇入基本资料属於不同的Thread，所以要设定二次的SaveAsync()。?

??????????? c. 如果在撰写汇入资料至ContactStore太久时，建议可以分批同步，可搭配Backgroun Agent的方式来定期分批汇入；??

?

至步骤B就完成了汇入联络人至ContactStore的任务，以下为执行的画面：

?

透过上图可以得知自行App所建立的ContactStore对於People Hub也是一个筛选的资料来源，因此，

如果用户安装了你的App之後一定会发现不认识的联络人增加了很多，此时，可以在App给一些提示告知他们如果隐藏这些联络人：

可至「设定->应用程式->联络人->筛选我的联络人清单」，取消勾选该App的资源来源。

?

?

C. 搜寻指定的联络人 ；

???? c-1. 定义搜寻的画面： 

<!--ContentPanel - place additional content here-->

CRLF 

<Grid x:Name="ContentPanel" Grid.Row="1" Margin="12,0,12,0">

CRLF 

    <Grid.RowDefinitions>

CRLF 

        <RowDefinition Height="13*" />

CRLF 

        <RowDefinition Height="25*" />

CRLF 

        <RowDefinition Height="62*" />

CRLF 

    </Grid.RowDefinitions>

CRLF 

    <TextBox Grid.Row="0" x:Name="txtName" />

CRLF 

    <StackPanel Grid.Row="1">

CRLF 

        <Button Content="Query" x:Name="btnQuery" Click="btnQuery_Click" />

CRLF 

        <Button Content="Delete" x:Name="btnDelete" Click="btnDelete_Click" />

CRLF 

    </StackPanel>

CRLF 

    <ListBox x:Name="lstContact" Grid.Row="2">

CRLF 

        <ListBox.ItemTemplate>

CRLF 

            <DataTemplate>

CRLF 

                <StackPanel Orientation="Horizontal" Margin="15">

CRLF 

                    <Border BorderThickness="2"

CRLF 

                            HorizontalAlignment="Left"

CRLF 

                            BorderBrush="{StaticResource PhoneAccentBrush}" >

CRLF 

                        <Image Source="{Binding Converter={StaticResource ContactPictureConverter}}"

CRLF 

                               Width="80" Height="60"

CRLF 

                               Stretch="Fill" />

CRLF 

                    </Border>

CRLF 

                    <StackPanel Margin="5">

CRLF 

                        <TextBlock Text="{Binding Path=DisplayName, Mode=OneWay}" VerticalAlignment="Center" />

CRLF 

                        <TextBlock Text="{Binding Path=FamilyName, Mode=OneWay}" VerticalAlignment="Center" />

CRLF 

                        <TextBlock Text="{Binding Path=RemoteId, Mode=OneWay}" VerticalAlignment="Center" />

CRLF 

                    </StackPanel>

CRLF 

                </StackPanel>

CRLF 

            </DataTemplate>

CRLF 

        </ListBox.ItemTemplate>

CRLF 

    </ListBox>

CRLF 

</Grid>

CRLF

?

???? c-2. 定义了IValueConvert负责将StoredContact中的DisplyPicture转换成WriteableBitmap； 

/// <summary>

CRLF 

/// 客制一个转换联络人图片的类别，透过实作IValueConverter Interface覆写指定转换的功能。

CRLF 

/// </summary>

CRLF 

public class ContactPictureConverter : IValueConverter

CRLF 

{

CRLF 

    public object Convert(object value, Type targetType, object parameter, System.Globalization.CultureInfo culture)

CRLF 

    {

CRLF 

        if (value == null) return null;

CRLF 

?

CRLF 

        StoredContact tC = value as StoredContact;

CRLF 

        // 取得DisplayPciture的值，采用Task的方式取代await的使用方法，强迫执行序等待

CRLF 

        var tTask = tC.GetDisplayPictureAsync().AsTask();

CRLF 

        tTask.Wait();

CRLF 

        // 将取得的IRandomAccessStream转换成Steam并建立成WriteableBitmap

CRLF 

        WriteableBitmap tWbmap = Microsoft.Phone.PictureDecoder.DecodeJpeg(tTask.Result.AsStream());

CRLF 

?

CRLF 

        return tWbmap;

CRLF 

    }

CRLF 

?

CRLF 

    public object ConvertBack(object value, Type targetType, object parameter, System.Globalization.CultureInfo culture)

CRLF 

    {

CRLF 

        throw new NotImplementedException();

CRLF 

    }

CRLF 

}

CRLF

?????????? 由於DisplyPicture的取得需采用非同步的方式，依照过去的写法一定会加上await，但这样会让IValueConvert无法识别回传值，

?????????? 所以 没有办法直接使用async + await的方式 。因此，这篇改用直接 将await转换成一个Task的物件，并且强迫该Task进行等待 ，

?????????? 等待取得图像IRandomAccessStream後，最後再转换成WriteableBitmap回传至Image物件。

?????????? 详细内容参考<XAML Image From Path>。

?

???? c-3. 定义搜寻的逻辑： 

private async void btnQuery_Click(object sender, RoutedEventArgs e)

CRLF 

{

CRLF 

    // 建立一个ContactQueryResult

CRLF 

    ContactQueryResult tResultObj = gMyCStore.CreateContactQuery();

CRLF 

?

CRLF 

    // 也可以搭配指定要搜寻的项目

CRLF 

    //ContactQueryOptions tOptions = new ContactQueryOptions();

CRLF 

    //tOptions.DesiredFields.Add(KnownContactProperties.Email);

CRLF 

    //tOptions.OrderBy = ContactQueryResultOrdering.SystemDefault;

CRLF 

    //ContactQueryResult tResultObj = gMyCStore.CreateContactQuery(tOptions);

CRLF 

?

CRLF 

    // 取得目前ContactStore中有联络人的数量

CRLF 

    uint tCount = await tResultObj.GetContactCountAsync();

CRLF 

?

CRLF 

    // 取得目前所有的联络人集合

CRLF 

    IReadOnlyList<StoredContact> tContacts = await tResultObj.GetContactsAsync();

CRLF 

?

CRLF 

    // 根据输入的文字搜寻StoredContact

CRLF 

    IEnumerable<StoredContact> tSearch = tContacts.Where(x => x.DisplayName.Contains(txtName.Text));

CRLF 

?

CRLF 

    lstContact.ItemsSource = tSearch;

CRLF 

}

CRLF

??????????? 配合ContactQueryResult的物件取得目前在ContactStore中所具有的所有StoredContact，并搭配LINQ进行搜寻。

?

D. 删除指定联络人的资料 ； 

private async void btnDelete_Click(object sender, RoutedEventArgs e)

CRLF 

{

CRLF 

    if (lstContact.SelectedIndex != -1)

CRLF 

    {

CRLF 

        StoredContact tContact = lstContact.SelectedItem as StoredContact;

CRLF 

        // 必须使用StoredContact.Id (local id)，因为该值是由系统给予的。

CRLF 

        await gMyCStore.DeleteContactAsync(tContact.Id);

CRLF 

?

CRLF 

        MessageBox.Show("移除成功!");

CRLF 

?

CRLF 

        ContactQueryResult tResultObj = gMyCStore.CreateContactQuery();

CRLF 

        lstContact.ItemsSource = await tResultObj.GetContactsAsync();

CRLF 

    }

CRLF 

}

CRLF

??? 根据选择指定的StoredContact，取得它的Id(local Id)指定给ContactStore来进行删除。

?

看一下执行的画面与结果：

?

E. 搭配vCard的处理：

??? 可参考<How to perform basic custom contact store operations for Windows Phone - ?Saving a contact from a vCard>

?

以上即是介绍如何操作自行建立的ContactStore。

?

[ 范例程式 ]

使用该范例程式时，记得 先将里面的RemoteContact.xml档案放至Dropbox或其他免费空间 ，并更换 b-3中的tURL变数 才有办法正常使用喔。

======

该篇文章我觉得对於如果您想要做App与People Hub加上整合或是扩充现有联络人的功能，

可以详细去了解其中的运作原理，这样可以让你的App更加的强力。

希望解释的还算清楚对大家有所帮助。

?

References ：

?Custom contact store for Windows Phone

?How to perform basic custom contact store operations for Windows Phone

?Building a Custom Contact Store in Your Windows Phone 8 Application

?Using the Windows Phone Custom Contact Store

?How to display the photo of a contact for Windows Phone

?Contact filtering and matching for Windows Phone & Contacts.SearchAsync Method

?Convert XML to Object using LINQ

?《深入浅出Windows Phone 8应用开发》之程序联系人存储

?Tag Archives: convert Stream to IRandomAccessStream

?Display Image from Stream in Windows 8 and Windows Phone 8

?Using User-Provided Images for Secondary Tiles

?Set display picture of StoredContact from byte[]

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

?Drawing / Inking API in WinRT (C#) – II

?

Dotblogs 的标签：Windows Phone

enjoy developing application and learning new technology time.

DotBlogs Tags:

Windows Phone

posted on
2014/2/13 16:09
|

我要推荐

|
阅读数 : 392

| 文章分类 [

Windows Phone

]

|
订阅

相关阅读

目录[+]