Allotja l'objecte a Power Apps
S'aplica a:
Aplicacions del llenç Aplicacions basades en models
L'objecte Host in proporciona informació sobre l'amfitrió actual que executa Power Apps l'aplicació.
Descripció
L'objecte Host proporciona informació sobre el dispositiu amfitrió, el sistema operatiu i el reproductor que està executant una aplicació. L'amfitrió és similar a l'objecte de l'aplicació i totes les aplicacions tenen accés a aquesta informació.
Un dels millors usos de Host és depurar una aplicació que no funciona correctament en un dispositiu específic o amb un navegador específic. Utilitzeu les propietats de text d'aquest objecte per mostrar informació a la interfície d'usuari de l'aplicació amb un control Etiqueta de text o registrar la informació a una taula de la base de dades o a Application Insights.
És temptador utilitzar Host per adaptar una aplicació a un dispositiu o navegador específic. Això és perillós, ja Power Apps que està dissenyat per executar-se en un ampli espectre de plataformes de maquinari i programari i la vostra lògica basada en l'amfitrió pot no explicar-les totes i canviaran amb el temps. El millor enfocament és utilitzar informació més abstracta i no lligada a maquinari i programari específics. Per exemple, utilitzeu la propietat Mida del control Pantalla per adaptar una pantalla perquè mostri menys o reorganitzar la informació quan s'executi en un dispositiu més petit, com ara un telèfon.
Per accedir a l'objecte Amfitrió, expandiu l'objecte Power Apps StudioAplicació a la part superior de la subfinestra de visualització en arbre i, a continuació, seleccioneu Host. En aquest exemple, l'objecte Host no té cap propietat que accepti fórmules.
Nota
Actualment, l'objecte amfitrió només està disponible a les pàgines personalitzades i a les aplicacions del llenç.
Propietat BrowserUserAgent
La propietat de text BrowserUserAgent conté la cadena completa d'agent d'usuari que el navegador utilitza per identificar-se quan executa l'aplicació.
Per exemple, una cadena d'agent d'usuari del navegador pot ser:
- Mozilla/5.0 (Windows NT 10.0; Guanyar64; x64)
- AppleWebKit/537.36 (KHTML, com Gecko)
- Chrome/109.0.0.0 Safari/537.36 Edg/109.0.1518.78
Nota
Si esteu executant Power Apps en una aplicació nativa o utilitzeu la funció en , l'aplicació es presenta mitjançant un control Empaqueta del navegador, que proporciona una cadena d'agent Power Apps d'usuari.
Propietat OSType
La propietat OSType proporciona el nom del sistema operatiu on s'està executant l'aplicació. L'OSType es determina a partir de la cadena d'agent d'usuari enviada pel navegador a Power Apps. Els següents són exemples de valors comuns per a OSType:
| Valor |
|---|
| Finestres |
| Mac OS |
| iOS |
| Android |
| Linux |
| ... |
Nota
No utilitzis l'OSType per canviar l'experiència o la funcionalitat de l'aplicació en funció del sistema operatiu del qual s'ha informat.
El text OSType es pot utilitzar en qualsevol fórmula, com ara mostrar-lo a la propietat de text d'una etiqueta:
Label1.Text: "You're running " & Host.OSType
Propietat SessionID
La propietat SessionID retorna el GUID que identifica la sessió actual. Incloeu aquesta informació quan informeu de problemes a l'administrador.
Nota
En situacions incrustades, com ara Power Apps in Power BI, la propietat SessionID retorna l'identificador de Power Apps sessió subjacent, no l'identificador de Power BI sessió.
Label1.Text: $"Provide session ID { Host.SessionID } to your administrator."
Propietat d'identificació de l'inquilí
La propietat TenantID proporciona l'identificador únic global (GUID) que especifica l'inquilí Microsoft Entra associat amb l'usuari autenticat actualment.
Nota
De manera similar a SessionID, en escenaris incrustats com Power Apps in, Power BI l'identificador d'inquilí és l'inquilí utilitzat per a l'autenticació de la Power Apps sessió.
Label1.Text: Host.TenantID
Propietat de la versió
La propietat Version proporciona la identificació i el Power Apps número de versió del reproductor. De manera similar a BrowserUserAgent, es pot retornar més d'un número de versió, separats per espais.
Nota
La propietat Version sempre és una cadena buida quan es treballa Power Apps Studio.
Label1.Text: Host.Version
Propietat OfflineEnabled
La propietat OfflineEnabled proporciona el mode d'execució de l'aplicació al Power Apps reproductor. En el cas de les aplicacions que no estan activades per a fora de línia, la propietat sempre és falsa. En el cas de les aplicacions habilitades per a fora de línia , la propietat és falsa al web, però certa activada iOS, Android i Windows.
Nota
Fins i tot si una aplicació de llenç no funciona sense connectivitat de xarxa, la propietat OfflineEnabled continua sent certa per a les aplicacions de llenç que s'han habilitat per a l'ús Power Apps Studio fora de línia.
Label1.Text: Host.OfflineEnabled
Exemples
- Creeu una aplicació de llenç nova.
- Afegiu un control Etiqueta de text i definiu la propietat a
Text."Host.BrowserUserAgent: " & Host.BrowserUserAgent - Afegiu un control Etiqueta de text i definiu la propietat a
Text."Host.OSType: " & Host.OSType - Afegiu un control Etiqueta de text i definiu la propietat a
Text."Host.SessionID: " & Host.SessionID - Afegiu un control Etiqueta de text i definiu la propietat a
Text."Host.TenantID: " & Host.TenantID - Afegiu un control Etiqueta de text i definiu la propietat a
Text."Host.Version: " & Host.Version - Afegiu un control Etiqueta de text i definiu la propietat a
Text."Host.OfflineEnabled: " & Host.OfflineEnabled
Executeu la vostra aplicació en diferents dispositius i amb diferents navegadors i veureu resultats similars als següents.
Power Apps Studio a Windows amb navegador Edge
Host.Version sempre està en blanc quan es treballa Power Apps Studio.
Host.BrowserUserAgent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Safari/537.36 Edg/116.0.1938.76
Host.OSType: Windows
Host.SessionID: ee2eed1a-8455-4e68-a433-a709302d0c71
Host.TenantID: 5da56e5c-97b6-468f-a448-a6e432c48269
Host.Version:
Power Apps Reproductor mòbil natiu activat iOS
Host.BrowserUserAgent: Mozilla/5.0 (iPhone; CPU iPhone OS 16_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 PowerApps/e1c23ff9-4822-4e75-a003-01c91407a4d2
Host.OSType: Windows
Host.SessionID: 3ebec22f-ee2e-412a-b3eb-45d97db34863
Host.TenantID: 5da56e5c-97b6-468f-a448-a6e432c48269
Host.Version: PowerApps-Native/3.23084.8(iOS)
Power Apps reproductor web a Windows amb Firefox navegador
Host.BrowserUserAgent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/117.0
Host.OSType: Windows
Host.SessionID: 283309a4-d88b-4b2a-88de-73b47d1b62d0
Host.TenantID: 5da56e5c-97b6-468f-a448-a6e432c48269
Host.Version: PowerApps-Web/3.23084.6(Windows)
Power Apps reproductor web activat iOS amb navegador Safari
Host.BrowserUserAgent: Mozilla/5.0 (iPhone; CPU iPhone OS 16_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6 Mobile/15E148 Safari/604.1
Host.OSType: iOS
Host.SessionID: a09a946d-ce71-4c1f-bd35-519c79849c8d
Host.TenantID: 5da56e5c-97b6-468f-a448-a6e432c48269
Host.Version: PowerApps-Web/3.23084.6(iOS)
Comentaris
Properament: al llarg del 2024 eliminarem gradualment GitHub Issues com a mecanisme de retroalimentació del contingut i el substituirem per un nou sistema de retroalimentació. Per obtenir més informació, consulteu: https://aka.ms/ContentUserFeedback.
Envieu i consulteu els comentaris de