MsalUiRequiredException 類別

定義

命名空間:: Microsoft.Identity.Client

組件:: Microsoft.Identity.Client.dll

套件:: Microsoft.Identity.Client v4.84.2

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

此例外類別是為了告知開發者，認證成功需要 UI 互動。它會在呼叫AcquireTokenSilent(IEnumerable<String>, IAccount)或其覆寫時拋出，或當快取中不存在令牌，或使用者需要提供更多內容，或根據 Azure AD 政策執行多重驗證等情況。如需詳細資訊，請參閱 https://aka.ms/msal-net-exceptions

public class MsalUiRequiredException : Microsoft.Identity.Client.MsalServiceException

type MsalUiRequiredException = class
    inherit MsalServiceException

Public Class MsalUiRequiredException
Inherits MsalServiceException

繼承: Exception

MsalException

MsalServiceException
MsalUiRequiredException

衍生: Microsoft.Identity.Client.MsalClaimsChallengeException

Microsoft.Identity.Client.MsalThrottledUiRequiredException

建構函式

名稱	Description
MsalUiRequiredException(String, String, Exception, UiRequiredExceptionClassification)	初始化一個新的例外類別實例，並以指定的錯誤代碼、錯誤訊息及內部例外指示根本原因。
MsalUiRequiredException(String, String, Exception)	初始化一個新的例外類別實例，並以指定的錯誤代碼、錯誤訊息及內部例外指示根本原因。
MsalUiRequiredException(String, String)	初始化一個新的例外類別實例，並指定錯誤代碼與錯誤訊息。

欄位

名稱	Description
BrokerErrorCode	AdditionalExceptionData使用桌面經紀人時可取得的房產金鑰。 (繼承來源 MsalException)
BrokerErrorContext	AdditionalExceptionData使用桌面經紀人時可取得的房產金鑰。 (繼承來源 MsalException)
BrokerErrorStatus	AdditionalExceptionData使用桌面經紀人時可取得的房產金鑰。 (繼承來源 MsalException)
BrokerErrorTag	AdditionalExceptionData使用桌面經紀人時可取得的房產金鑰。 (繼承來源 MsalException)
BrokerTelemetry	AdditionalExceptionData使用桌面經紀人時可取得的房產金鑰。 (繼承來源 MsalException)
ManagedIdentitySource	一個 AdditionalExceptionData 屬性金鑰，在使用管理身份時可用。 (繼承來源 MsalException)

屬性

名稱	Description
AdditionalExceptionData	一個包含此例外細節的財產袋。 (繼承來源 MsalException)
Claims	服務方要求的額外理賠。當此屬性非空或空時，表示服務要求使用者提供額外要求，例如進行雙重驗證。有兩種情況：如果你的應用程式是 IPublicClientApplication，你應該直接打電話 AcquireTokenInteractive(IEnumerable<String>) 並加上 WithClaims(String) 修飾符。如果你的應用程式是 IConfidentialClientApplication，（因此執行 On-Behalf-Of 流程），你應該拋出一個 HTTP 未授權例外，並附上包含聲明的訊息更多詳情請參見 https://aka.ms/msal-net-claim-challenge (繼承來源 MsalServiceException)
Classification	條件存取錯誤的分類，讓您能根據情境執行更多操作或通知使用者。如需詳細資訊，請參閱 https://aka.ms/msal-net-UiRequiredException。
CorrelationId	一個可以用來拼湊單一認證流程的 ID。 (繼承來源 MsalException)
ErrorCode	取得服務回傳或由用戶端產生的協定錯誤碼。這是你可以信賴的例外處理程式碼。此程式碼的值通常以導出例外類型中的常數字串形式提供，並附有緩解說明。 (繼承來源 MsalException)
Headers	包含伺服器回應中指示錯誤的 HTTP 標頭。 (繼承來源 MsalServiceException)
IsRetryable	指示是否應重試導致此例外的先前操作。 (繼承來源 MsalException)
ResponseBody	伺服器收到的原始回應正文。 (繼承來源 MsalServiceException)
StatusCode	從 HTTP 層回傳狀態碼。此狀態碼要麼`HttpStatusCode`是內部HttpRequestException回應中的 NavigateError 事件狀態碼，要麼是瀏覽器流程中的 NavigateError 事件狀態碼（參見 NavigateError 事件狀態碼）。你可以用這些程式碼來實作重試邏輯或錯誤調查等用途。 (繼承來源 MsalServiceException)

方法

名稱	Description
ToJsonString()	允許將大部分例外值序列化成 JSON。 (繼承來源 MsalException)
ToString()	建立並傳回目前例外狀況的字串表示。 (繼承來源 MsalServiceException)
UpdateIsRetryable()	根據與 Evo 的討論，AAD (繼承來源 MsalServiceException)

適用於

意見反應

此頁面對您有幫助嗎？