Langue

MsalException Classe

Définition

Espace de noms:
Microsoft.Identity.Client
Assembly:
Microsoft.Identity.Client.dll
Package:
Microsoft.Identity.Client v4.91.0

Type d’exception de base levée lorsqu’une erreur se produit lors de l’acquisition de jetons. Pour plus d'informations, voir https://aka.ms/msal-net-exceptions

public class MsalException : Exception
type MsalException = class
    inherit Exception
Public Class MsalException
Inherits Exception
Héritage
Exception
MsalException
Dérivé

Remarques

Évitez de lever cette exception. Au lieu de cela, jetez le plus spécialisé MsalClientException ou MsalServiceException

Constructeurs

Nom Description
MsalException()

Initialise une nouvelle instance de la classe d’exception.
MsalException(String, String, Exception)

Initialise une nouvelle instance de la classe d’exception avec un code d’erreur spécifié et une référence à l’exception interne qui est la cause de cette exception.
MsalException(String, String)

Initialise une nouvelle instance de la classe d’exception avec un code d’erreur et un message d’erreur spécifiés.
MsalException(String)

Initialise une nouvelle instance de la classe d’exception avec un code d’erreur spécifié.

Champs

Nom Description
AuthenticationResultMetadataKey

Clé sur Data laquelle MSAL stocke la AuthenticationResultMetadata capture lorsqu’une acquisition de jetons échoue avec un non-MsalException. Permet aux consommateurs en aval de surfacer les diagnostics d’acquisition de jetons même si l’exception d’origine est levée à nouveau inchangée.
BrokerErrorCode

Clé AdditionalExceptionData de propriété disponible lors de l’utilisation de répartiteurs de bureau.
BrokerErrorContext

Clé AdditionalExceptionData de propriété disponible lors de l’utilisation de répartiteurs de bureau.
BrokerErrorStatus

Clé AdditionalExceptionData de propriété disponible lors de l’utilisation de répartiteurs de bureau.
BrokerErrorTag

Clé AdditionalExceptionData de propriété disponible lors de l’utilisation de répartiteurs de bureau.
BrokerTelemetry

Clé AdditionalExceptionData de propriété disponible lors de l’utilisation de répartiteurs de bureau.
ManagedIdentitySource

Clé AdditionalExceptionData de propriété disponible lors de l’utilisation de l’identité managée.

Propriétés

Nom Description
AdditionalExceptionData

Un conteneur de propriétés avec des détails supplémentaires pour cette exception.
AuthenticationResultMetadata

Métadonnées de diagnostic pour la tentative d’acquisition de jeton ayant échoué : durée totale et, lorsque l’étape appropriée a été exécutée, les durées HTTP/cache, le point de terminaison de jeton et la région utilisés. Il s’agit null du moment où l’exception a été levée avant que le pipeline de requête ne commence à collecter les métadonnées (par exemple, la validation du paramètre ou du générateur). Lorsqu’il n’est pas null ( l’échec classique de la demande) DurationTotalInMs est toujours rempli (utile pour la mesure de latence), tandis que les autres champs peuvent être 0/null lorsque l’étape correspondante n’a pas été exécutée. En cas d’échec TokenSource n’a aucune valeur significative et ne doit pas être utilisé. Réutilise le type retourné par AuthenticationResultMetadata sur le chemin de réussite.
CorrelationId

ID qui peut être utilisé pour fragmenter un seul flux d’authentification.
ErrorCode

Obtient le code d’erreur du protocole retourné par le service ou généré par le client. Il s’agit du code sur lequel vous pouvez vous appuyer pour la gestion des exceptions. Les valeurs de ce code sont généralement fournies dans des chaînes constantes dans les types d’exceptions dérivés avec des explications d’atténuation.
IsRetryable

Indique si l’opération précédente qui a entraîné cette exception doit être retentée.

Méthodes

Nom Description
FromJsonString(String)

Autorise la réactivation de MsalException (ou l’un de ses types dérivés) à partir de JSON généré par ToJsonString().
ToJsonString()

Permet la sérialisation de la plupart des valeurs de l’exception en JSON.
ToString()

Crée et retourne une représentation sous forme de chaîne de l’exception actuelle.

S’applique à