User 函數

適用於: 畫布應用程式 Dataverse 函數 Power Pages

傳回目前使用者的相關資訊。

Description

函式會 User 傳回目前使用者的相關資訊 記錄 :

屬性 Description
User().電子郵件 目前使用者的電子郵件地址。 User().Email 函式會傳回使用者的 UPN,而非 SMTP 電子郵件地址。
User().EntraObjectId 目前使用者的 Microsoft Entra 物件識別碼,適用於呼叫使用此值的 API。 這是 GUID 值,對於每個使用者來說都是唯一的。
User().全名 目前使用者的全名,包括姓氏與名字。
User().像 目前使用者的影像。 這將是表單 "blob:identifier" 的映像 URL。 將 Image 控制項的 Image 屬性設定為此值,以在應用程式中顯示影像。

Note

傳回的資訊適用於目前的 Power Apps 使用者。 它會與 Power Apps 播放程式與工作室中顯示的 "帳戶" 資訊相符,同時也可在任何已撰寫的應用程式之外找到。 此資訊可能與 Office 365 或其他服務中目前的使用者資訊不相符。

Note

如果您在 2020 年 3 月之前發布了具有功能的 User 應用程序,您可能會發現它間歇性地無法檢索照片。 問題已在 2020 年 3 月下旬的版本中修正。 若要善用更新的實施做法,只需重新開啟應用程式、儲存並重新發佈即可。

語法

User()

範例

目前 Power Apps 使用者具有下列資訊︰

  • 全名:"John Doe"
  • 電子郵件地址:"john.doe@contoso.com"
  • Entra 物件 ID: aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb(GUID)
  • 影像:影像圖示。
公式 Description Result
User() 目前 Power Apps 使用者所有資訊的記錄。 { FullName: "John Doe",電子郵件:"john.doe@contoso.com", 影像:"blob:1234...5678", EntraObjectId: a90c6800‑e58c‑4495‑81f7‑55819b56fe2a }
User().電子郵件 Power Apps 使用者的電子郵件地址。 「john.doe@contoso.com」
User().全名 目前 Power Apps 使用者的全名。 “約翰·多伊”
User().EntraObjectId 目前使用者的 Microsoft Entra 物件識別碼。 aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb (GUID)
User().像 目前 Power Apps 使用者的映像 URL。 將 Image 控制項的 Image 屬性設定為此值,以在應用程式中顯示影像。 "blob:1234...5678"

含 ImageControl.Image:
影像圖示 1。