Condividi tramite


Avviare l'app People

Importante

L'app Contatti di Windows ha terminato il supporto il 31 dicembre 2024 ed è stata rimossa da Windows 11 versione 24H2 e successive. Lo schema URI ms-people: documentato in questa pagina non è più funzionale nelle installazioni Windows 11 moderne. Per la gestione dei contatti nelle applicazioni, vedere il nuovo Outlook per Windows.

Questa documentazione viene mantenuta a scopo di riferimento per gli sviluppatori che usano versioni precedenti di Windows.

In questo argomento viene descritto lo schema URI ms-people: . Le tue app WinUI, UWP e altre app desktop di Windows possono usare questo schema URI per avviare l'app Persone per azioni specifiche.

ms-people: riferimento allo schema URI

Risultati Schema di URI
Consente ad altre app di avviare la pagina principale dell'app People. ms-people:
Consente ad altre app di avviare la pagina impostazioni dell'app Persone. ms-people:impostazioni
Consente ad altre app di fornire una stringa di ricerca che avvierà l'app People con la pagina dei risultati della ricerca.

I parametri fanno distinzione tra maiuscole e minuscole.

Se non si immette correttamente la sintassi o manca il valore della stringa di ricerca, il comportamento predefinito consiste nel restituire un elenco completo dei contatti senza filtri.

ms-people:search?SearchString=<contactsearchinfo>
Viene avviato a una scheda contatto esistente, se viene trovato il contatto. In alternativa, avvia una scheda contatto temporanea, se non viene trovato alcun contatto. Se non viene specificato alcun parametro di input, verrà avviata l'app People con un elenco contatti.

I parametri fanno distinzione tra maiuscole e minuscole.

L'ordine dei parametri non è importante.

Se ci sono più corrispondenze, restituiremo la prima corrispondenza di contatto.

 
ms-people:viewcontact? ContactId=<contactid>&AggregatedId=<aggid>&PhoneNumber= <phonenum>&Email=<email>&ContactName=<name>&Contact=<contactobj>
Viene avviata una pagina Salva contatto all'interno dell'app Contatti per salvare il contatto specificato con il numero di telefono o l'indirizzo di posta elettronica fornito.

I parametri fanno distinzione tra maiuscole e minuscole.

L'ordine dei parametri non è importante.

ms-people:savetocontact? PhoneNumber= <phonenum>&Email=<email>&ContactName=<name>
Avvia per aggiungere una nuova pagina di contatto all'interno dell'app Contatti per salvare il contatto specificato.

Usare LaunchUriForResultsAsync per aprire la pagina salva nuovo contatto. L'uso di LaunchUriAsync avvierà solo la pagina principale dell'app People.

I parametri fanno distinzione tra maiuscole e minuscole.

L'ordine dei parametri non è importante.

È possibile usare qualsiasi combinazione di parametri supportati.

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

ms-people:search: riferimento ai parametri

Parametro Descrizione Esempio
SearchString

Opzionale.

Stringa di ricerca per le informazioni di ricerca dei contatti.

Numero di telefono o nome del contatto.

ms-people:search?SearchString=Smith

ms-people:viewcontact: riferimento ai parametri

Parametro Descrizione Esempio
ContactId

Opzionale.

ID del contatto.

ms-people:viewcontact?ContactId={ContactId}

Numero di Telefono

Opzionale.

Numero di telefono del contatto.

ms-people:viewcontact?PhoneNumber=%2014257069326

E-mail

Opzionale.

Indirizzo di posta elettronica del contatto.

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

Contactname

Opzionale.

Nome del contatto.

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

Contatto

Opzionale.

L'oggetto contatto.

ms-people:viewcontact?Contact={Contatto serializzato}

ms-people:savetocontact: riferimento del parametro

Parametro Descrizione Esempio
Numero di Telefono

Opzionale.

Numero di telefono del contatto.

ms-people:savetocontact?PhoneNumber=%2014257069326

E-mail

Opzionale.

Indirizzo di posta elettronica del contatto.

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

Contactname

Opzionale.

Nome del contatto.

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

ms-people:savecontacttask: riferimento ai parametri

Parametro Descrizione
Azienda

Opzionale.

Nome della società del contatto.

FirstName

Opzionale.

Nome del contatto.

HomeAddressCity

Opzionale.

Città dell'indirizzo di casa.

HomeAddressCountry

Opzionale.

Paese dell'indirizzo di casa.

HomeAddressState

Opzionale.

Stato dell'indirizzo di casa.

HomeAddressStreet

Opzionale.

Via dell'indirizzo di casa.

HomeAddressZipCode

Opzionale.

Codice postale dell'indirizzo di casa.

HomePhone

Opzionale.

Telefono di casa del contatto.

JobTitle

Opzionale.

Titolo professionale del contatto.

LastName

Opzionale.

Cognome del contatto.

MiddleName

Opzionale.

Secondo nome del contatto.

Telefono cellulare

Opzionale.

Numero di telefono cellulare del contatto.

Soprannome

Opzionale.

Soprannome del contatto.

Note

Opzionale.

Note sul contatto.

Altra Email

Opzionale.

Altro messaggio di posta elettronica del contatto.

PersonalEmail

Opzionale.

Email personale del contatto.

suffisso

Opzionale.

Suffisso del contatto.

Titolo

Opzionale.

Titolo del contatto.

Sito web

Opzionale.

Sito Web del contatto.

CittàIndirizzoLavoro

Opzionale.

Città dell'indirizzo di lavoro.

WorkAddressCountry

Opzionale.

Paese dell'indirizzo di lavoro.

WorkAddressState

Opzionale.

Stato dell'indirizzo di lavoro.

WorkAddressStreet

Opzionale.

Via dell'indirizzo di lavoro.

WorkAddressZipCode

Opzionale.

CAP dell'indirizzo di lavoro.

WorkEmail

Opzionale.

Indirizzo di posta elettronica aziendale del contatto.

WorkPhone

Opzionale.

Numero di telefono aziendale del contatto.

Avvia un Windows app con un URI

Avviare l'app predefinita per un URI