启动“人脉”应用Launch the People app

本主题介绍ms 人: URI 方案。This topic describes the ms-people: URI scheme. 你的应用可以使用此 URI 方案来针对特定操作启动“人脉”应用。Your app can use this URI scheme to launch the People app for specific actions.

ms-people:URI 方案引用ms-people: URI scheme reference

结果Results URI 方案URI scheme
允许其他应用启动“人脉”应用主页。Allows other apps to launch the People app Main page. ms-people:ms-people:
允许其他应用启动“人脉”应用设置页。Allows other apps to launch the People app Settings page. ms-people:settingsms-people:settings
允许其他应用通过搜索的结果页提供将启动“人脉”应用的搜索字符串。Allows other apps to provide a search string that will launch the People app with the result page of the search.

参数区分大小写。The parameters are case sensitive.

如果未正确输入语法或缺少搜索字符串值,默认行为是返回未经过任何筛选的联系人的完整列表。If you do not enter the syntax correctly, or are missing the search string value, the default behavior is to return a full list of contacts without any filtering.

ms-people:search?SearchString=<contactsearchinfo>ms-people:search?SearchString=<contactsearchinfo>
如果找到该联系人,将启动到现有的联系人卡片。Launches to an existing contact card, if the contact is found. 或者,如果未找到联系人,将启动到临时的联系人卡片。Or, launches to a temporary contact card, if no contact is found. 如果未提供输入参数,我们将启动带有联系人列表的“人脉”应用。If no input parameter is supplied, we will launch the People App with a contact list.

参数区分大小写。The parameters are case sensitive.

参数的顺序无关紧要。The order of the parameters doesn’t matter.

如果存在多个匹配,我们将返回匹配的第一个联系人。If there is more than one match, we will return the first match of the contact.

 
ms-人: viewcontact?ContactId =<contactid>&AggregatedId =<aggid>&PhoneNumber = <phonenum>&电子邮件 =<电子邮件> &ContactName =<名称>&联系人 =<contactobj>ms-people:viewcontact?ContactId=<contactid>&AggregatedId=<aggid>&PhoneNumber= <phonenum>&Email=<email>&ContactName=<name>&Contact=<contactobj>
启动到“人脉”应用内的保存联系人页面,以使用提供的电话号码或电子邮件地址保存给定的联系人。Launches to a Save-contact page within the People app to save the given contact with the supplied phone number or email address.

参数区分大小写。The parameters are case sensitive.

参数的顺序无关紧要。The order of the parameters doesn’t matter.

ms-people:savetocontact?PhoneNumber= <phonenum>&Email=<email>&ContactName=<name>ms-people:savetocontact?PhoneNumber= <phonenum>&Email=<email>&ContactName=<name>
启动以在“人脉”应用中添加新联系人页面,用于保存给定联系人。Launches to the add a new contact page within the People app to save the given contact.

使用 LaunchUriForResultsAsync 打开“保存新联系人”页面。Use LaunchUriForResultsAsync to open the save new contact page. 使用 LaunchUriAsync 将只启动“人脉”应用的主页。Using LaunchUriAsync will only launch the People app Main page.

参数区分大小写。The parameters are case sensitive.

参数的顺序无关紧要。The order of the parameters doesn’t matter.

你可以使用受支持参数的任意组合。You can use any combination of supported parameters.

ms-people:savecontacttask?PhoneNumber= <phonenum>&Email=<email>&ContactName=<name>ms-people:savecontacttask?PhoneNumber= <phonenum>&Email=<email>&ContactName=<name>

ms-people:search: 参数引用ms-people:search: parameter reference

参数Parameter 描述Description 示例Example
SearchStringSearchString

可选。Optional.

联系人搜索信息的搜索字符串。The search string for the contact search information.

电话号码或联系人姓名。The phone number or the contact name.

ms-people:search?SearchString=Smithms-people:search?SearchString=Smith

ms-people:viewcontact: 参数引用ms-people:viewcontact: parameter reference

参数Parameter 描述Description 示例Example
ContactIdContactId

可选。Optional.

联系人的联系人 ID。Contact Id of the contact.

ms-people:viewcontact?ContactId={ContactId}ms-people:viewcontact?ContactId={ContactId}

电话号码PhoneNumber

可选。Optional.

联系人的电话号码。Phone number of the contact.

ms-people:viewcontact?PhoneNumber=%2014257069326ms-people:viewcontact?PhoneNumber=%2014257069326

电子邮件Email

可选。Optional.

联系人的电子邮件。Email of the contact.

ms-people:viewcontact?Email=johnsmith@contsco.comms-people:viewcontact?Email=johnsmith@contsco.com

联系人姓名ContactName

可选。Optional.

联系人的姓名。Name of the contact.

ms-people:viewcontact?ContactName=John%20%Smithms-people:viewcontact?ContactName=John%20%Smith

请联系Contact

可选。Optional.

Contact 对象。Contact object.

ms-people:viewcontact?Contact={Serialized Contact}ms-people:viewcontact?Contact={Serialized Contact}

ms-people:savetocontact: 参数引用ms-people:savetocontact: parameter reference

参数Parameter 描述Description 示例Example
电话号码PhoneNumber

可选。Optional.

联系人的电话号码。Phone number of the contact.

ms-people:savetocontact?PhoneNumber=%2014257069326ms-people:savetocontact?PhoneNumber=%2014257069326

电子邮件Email

可选。Optional.

联系人的电子邮件。Email of the contact.

ms-people:savetocontact?Email=johnsmith@contsco.comms-people:savetocontact?Email=johnsmith@contsco.com

联系人姓名ContactName

可选。Optional.

联系人的姓名。Name of the contact.

ms-people:savetocontact?Email=johnsmith@contsco.com&ContactName= John%20%Smithms-people:savetocontact?Email=johnsmith@contsco.com&ContactName= John%20%Smith

ms-people:savecontacttask: 参数引用ms-people:savecontacttask: parameter reference

参数Parameter 描述Description
公司Company

可选。Optional.

联系人的公司名称。Company name of the contact.

FirstNameFirstName

可选。Optional.

联系人的名字。First name of the contact.

HomeAddressCityHomeAddressCity

可选。Optional.

家庭地址所在城市。City of the home address.

HomeAddressCountryHomeAddressCountry

可选。Optional.

家庭地址所在国家/地区。Country of the home address.

HomeAddressStateHomeAddressState

可选。Optional.

家庭地址所在州。State of the home address.

HomeAddressStreetHomeAddressStreet

可选。Optional.

家庭地址所在街道。Street of the home address.

HomeAddressZipCodeHomeAddressZipCode

可选。Optional.

家庭地址的邮政编码。Zip Code of the home address.

住宅电话HomePhone

可选。Optional.

联系人的家庭电话。Home phone of the contact.

JobTitleJobTitle

可选。Optional.

联系人的职务。Job title of the contact.

姓氏LastName

可选。Optional.

联系人的姓氏。Last name of the contact.

MiddleNameMiddleName

可选。Optional.

联系人的中间名。Middle name of the contact.

MobilePhoneMobilePhone

可选。Optional.

联系人的移动电话号码。Mobile phone number of the contact.

昵称Nickname

可选。Optional.

联系人的昵称。Nickname of the contact.

注意Notes

可选。Optional.

关于联系人的备注。Notes about the contact.

OtherEmailOtherEmail

可选。Optional.

联系人的其他电子邮件。Other Email of the contact.

PersonalEmailPersonalEmail

可选。Optional.

联系人的个人电子邮件。Personal Email of the contact.

后缀Suffix

可选。Optional.

联系人的后缀。Suffix of the contact.

TitleTitle

可选。Optional.

联系人的职务。Title of the contact.

网站Website

可选。Optional.

联系人的网站。Website of the contact.

WorkAddressCityWorkAddressCity

可选。Optional.

工作地址所在城市。City of the work address.

WorkAddressCountryWorkAddressCountry

可选。Optional.

工作地址所在国家/地区。Country of the work address.

WorkAddressStateWorkAddressState

可选。Optional.

工作地址所在州。State of the work address.

WorkAddressStreetWorkAddressStreet

可选。Optional.

工作地址所在街道。Street of work address.

WorkAddressZipCodeWorkAddressZipCode

可选。Optional.

工作地址的邮政编码。Zip Code of the work address.

工作电子邮件WorkEmail

可选。Optional.

联系人的工作电子邮件。Work Email of the contact.

办公电话WorkPhone

可选。Optional.

联系人的工作电话号码。Work phone number of the contact.