Teilen über

Host-Objekt in Power Apps

  • Artikel

Gilt für: Canvas-Apps Modellgesteuerte Apps

Das Objekt Host in Power Apps stellt Informationen über den aktuellen Host bereit, auf dem die App ausgeführt wird.

Beschreibung

Das Host-Objekt stellt Informationen über das Hostgerät, das Betriebssystem und den Player bereit, auf dem eine App ausgeführt wird. Host ähnelt dem App- Objekt und jede App hat Zugriff auf diese Informationen.

Eine der besten Einsatzmöglichkeiten von Host ist das Debuggen einer App, die auf einem bestimmten Gerät oder mit einem bestimmten Browser nicht richtig funktioniert. Verwenden Sie die Texteigenschaften dieses Objekts, um Informationen in der Benutzeroberfläche der App mit einem Textbeschriftung-Steuerelement anzuzeigen oder die Informationen in einer Datenbanktabelle oder Application Insights zu protokollieren.

Es ist verlockend, Host zu verwenden, um eine App an ein bestimmtes Gerät oder einen bestimmten Browser anzupassen. Das ist gefährlich, da Power Apps so konzipiert ist, dass es auf einem breiten Spektrum von Hardware- und Softwareplattformen ausgeführt werden kann. Ihre Host-basierte Logik kann möglicherweise nicht alle berücksichtigen, und sie werden sich im Laufe der Zeit ändern. Der bessere Ansatz besteht darin, Informationen zu verwenden, die stärker abstrahiert und nicht an bestimmte Hardware und Software gebunden sind. Verwenden Sie zum Beispiel die Eigenschaft Size des Screen-Steuerelements, um einen Bildschirm so anzupassen, dass bei der Ausführung auf einem kleineren Gerät wie einem Telefon weniger angezeigt oder Informationen neu organisiert werden.

Um auf das Host-Objekt in Power Apps Studio zuzugreifen, erweitern Sie das App-Objekt oben im Bereich Baumsicht, und wählen Sie dann Host aus. In diesem Beispiel hat das Objekt Host keine Eigenschaften, die Formeln akzeptieren.

Das Host-Objekt in der Strukturansicht.

Anmerkung

Das Host-Objekt ist derzeit nur in benutzerdefinierten Seiten und Canvas-Apps verfügbar.

BrowserUserAgent-Eigenschaft

Die Texteigenschaft BrowserUserAgent enthält die vollständige Benutzer-Agent-Zeichenfolge, mit der sich der Browser beim Ausführen der App identifiziert.

Eine Browser-Benutzer-Agent-Zeichenfolge könnte beispielsweise so aussehen:

  • Mozilla/5.0 (Windows NT 10.0; Win64; x64)
  • AppleWebKit/537.36 (KHTML, wie Gecko)
  • Chrome/109.0.0.0 Safari/537.36 Edg/109.0.1518.78

Anmerkung

Wenn Sie Power Apps in einer nativen App ausführen oder das Verpacken-Feature in Power Apps verwenden, wird die App über ein Browsersteuerelement präsentiert, das eine Benutzer-Agent-Zeichenfolge bereitstellt.

OSType-Eigenschaft

Die Eigenschaft OSType stellt den Namen des Betriebssystems bereit, auf dem die App ausgeführt wird. Der OSType wird aus der vom Browser an Power Apps gesendeten Benutzer-Agent-Zeichenfolge bestimmt. Im Folgenden finden Sie Beispiele für übliche Werte für OSType:

Wert
Window
Mac OS
iOS
Android
Linux
...

Anmerkung

Benutzen Sie nicht OSType, um das Erlebnis oder die Funktionalität Ihrer App basierend auf dem gemeldeten Betriebssystem zu ändern.

Der OSType-Text kann in jeder Formel verwendet werden, z. B. indem er in der Texteigenschaft einer Beschriftung angezeigt wird:

Label1.Text: "You're running " & Host.OSType

SessionID-Eigenschaft

Die Eigenschaft SessionID gibt die GUID zurück, die die aktuelle Sitzung identifiziert. Geben Sie diese Informationen an, wenn Sie Probleme an Ihren Administrator melden.

Anmerkung

In eingebetteten Szenarien wie Power Apps in Power BI gibt die SessionID-Eigenschaft die zugrunde liegende Power Apps-Sitzungs-ID zurück, nicht die Power BI-Sitzungs-ID.

Label1.Text: $"Provide session ID { Host.SessionID } to your administrator."

TenantID-Eigenschaft

Die Eigenschaft TenantID stellt den Globally Unique Identifier (GUID) bereit, der den Microsoft Entra-Mandanten angibt, der dem derzeit authentifizierten Benutzenden zugeordnet ist.

Anmerkung

Ähnlich wie bei der SessionID ist die Mandanten-ID in eingebetteten Szenarien wie Power Apps in Power BI der Mandant, der für Authentifizierung der Power Apps-Sitzung.

Label1.Text: Host.TenantID

Eigenschaft „Version“

Die Eigenschaft Version stellt die Identifikation und Versionsnummer des Power Apps-Players bereit. Ähnlich zu BrowserUserAgent kann mehr als eine Versionsnummer zurückgegeben werden, getrennt durch Leerzeichen.

Anmerkung

Die Eigenschaft Version ist beim Arbeiten in Power Apps Studio immer eine leere Zeichenfolge.

Label1.Text: Host.Version

Eigenschaft OfflineEnabled

Die Eigenschaft OfflineEnabled stellt den Laufzeitmodus der App im Power Apps-Player bereit. Für Apps, die nicht für die Offline-Nutzung aktiviert sind, ist die Eigenschaft immer falsch. Für Apps, die für die Offline-Nutzung aktiviert sind, ist die Eigenschaft im Web falsch, aber in iOS, Android und Windows wahr.

Anmerkung

Auch wenn eine Canvas-App ohne Netzwerkkonnektivität nicht funktioniert, bleibt die Eigenschaft OfflineEnabled für Canvas-Apps, die für die Offline-Verwendung aktiviert wurden, in Power Apps Studio wahr.

Label1.Text: Host.OfflineEnabled

Beispiele

  1. Erstellen Sie eine neue Canvas-App.
  2. Fügen Sie ein Textbeschriftung-Steuerelement hinzu, und legen Sie die Text-Eigenschaft auf "Host.BrowserUserAgent: " & Host.BrowserUserAgent fest.
  3. Fügen Sie ein Textbeschriftung-Steuerelement hinzu, und legen Sie die Text-Eigenschaft auf "Host.OSType: " & Host.OSType fest.
  4. Fügen Sie ein Textbeschriftung-Steuerelement hinzu, und legen Sie die Text-Eigenschaft auf "Host.SessionID: " & Host.SessionID fest.
  5. Fügen Sie ein Textbeschriftung-Steuerelement hinzu, und legen Sie die Text-Eigenschaft auf "Host.TenantID: " & Host.TenantID fest.
  6. Fügen Sie ein Textbeschriftung-Steuerelement hinzu, und legen Sie die Text-Eigenschaft auf "Host.Version: " & Host.Version fest.
  7. Fügen Sie ein Textbeschriftung-Steuerelement hinzu, und legen Sie die Text-Eigenschaft auf "Host.OfflineEnabled: " & Host.OfflineEnabled fest.

Führen Sie Ihre App auf verschiedenen Geräten und mit unterschiedlichen Browsern aus und Sie werden ähnliche Ergebnisse wie die folgenden sehen.

Power Apps Studio unter Windows mit Edge-Browser

Host.Version ist beim Arbeiten in Power Apps Studio immer leer.

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:

Nativer mobiler Power Apps-Player auf 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-Webplayer unter Windows mit Firefox-Browser

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-Webplayer unter iOS mit Safari-Browser

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)