ContactsSearchEventArgs 类

2013/12/13

SearchCompleted 事件提供数据。

System.Object
  System.EventArgs
    Microsoft.Phone.UserData.ContactsSearchEventArgs

Namespace:  Microsoft.Phone.UserData
程序集:  Microsoft.Phone(位于 Microsoft.Phone.dll 中)

public sealed class ContactsSearchEventArgs : EventArgs

ContactsSearchEventArgs 类型公开以下成员。

  名称说明
公共属性Filter获取用于搜索的筛选器。
公共属性FilterKind获取用于搜索的筛选器种类。
公共属性Results获取搜索联系人的结果。
公共属性State获取一个用户定义的对象,该对象包含有关操作的信息。
返回顶部

  名称说明
公共方法Equals(Object)确定指定的 Object 是否等于当前的 Object (从 Object 继承。)
受保护的方法Finalize允许 Object 在垃圾回收器回收该对象之前尝试释放资源并执行其他清理操作。 (从 Object 继承。)
公共方法GetHashCode用作特定类型的哈希函数。 (从 Object 继承。)
公共方法GetType获取当前实例的 Type (从 Object 继承。)
受保护的方法MemberwiseClone创建当前 Object 的浅表副本。 (从 Object 继承。)
公共方法ToString返回一个字符串,它表示当前的对象。 (从 Object 继承。)
返回顶部

当由 SearchAsync 方法启动的对联系人的搜索完成时,该类的实例传递给 SearchCompleted 事件。

功能

如果您在应用中使用此 API,您必须在应用清单中指定下列功能。否则,您的应用可能无法正常工作,或可能意外退出。

ID_CAP_CONTACTS

Windows Phone 8

ID_CAP_APPOINTMENTS

Windows Phone 8

有关更多信息,请参见 Windows Phone 应用的功能和硬件要求

以下示例假定您拥有一个 Windows Phone 应用程序,该应用程序包含一个带有名为 ContactResultsData 的数据绑定列表框的页面。有关包含 XAML 的完整示例,请参见如何访问 Windows Phone 的联系人数据

void Contacts_SearchCompleted(object sender, ContactsSearchEventArgs e)
{
    MessageBox.Show(e.State.ToString());
    MessageBox.Show(e.FilterKind.ToString());
    MessageBox.Show(e.Filter.ToString());

    try
    {
        //Bind the results to the list box that displays them in the UI.
        ContactResultsData.DataContext = e.Results;
    }
    catch (System.Exception)
    {
        //That's okay, no results.
    }
}

Windows Phone OS

受以下版本支持: 8.0, 7.1

Windows Phone

此类型的所有公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

显示:
© 2014 Microsoft