ContactManager.ShowContactCard | showContactCard Methods

在操作系统中查询用户联系人并在联系人卡片中显示联系人数据。 通常情况下,这会显示一个 UI,但某些错误情况下,可能不会显示该 UI。请参见“备注”。

重载列表

方法说明
ShowContactCard(Contact, Rect) Queries the operating system for a user’s contact and shows the contact data in a contact card.
ShowContactCard(Contact, Rect, Placement) Queries the operating system for a user’s contact and shows the contact data in a contact card.

备注

注意  源应用程序必须在前台运行才能调用 ShowContactCard 方法之一。在后台运行的应用程序将会获得“访问被拒绝”异常,如果调用 ShowContactCard 方法。

大多数典型的操作将会导致显示 UI。

  • 如果所请求的联系人有一个完全匹配项:显示联系人卡片 UI 以及操作系统中的联系人存储内的信息。
  • 如果有多个匹配项:显示找到的第一个匹配联系人的联系人卡片 UI。
  • 如果没有匹配项:显示联系人卡片 UI,其中联系人信息来自输入 contact 对象。

如果有错误,例如 contact 参数的输入无效,则不显示 UI。

针对查询目的,电话号码支持字符 0-9 和 a-z/A-Z。如果你在电话号码中输入任何其他字符,当你查询联系人时它们会被忽略。

要求

最低支持客户端

Windows 8.1

最低支持服务器

Windows Server 2012 R2

命名空间

Windows.ApplicationModel.Contacts
Windows::ApplicationModel::Contacts [C++]

元数据

Windows.winmd

另请参见

ContactManager
Contact

 

 

显示:
© 2014 Microsoft