Lingua

MsalException Classe

Definizione

Spazio dei nomi:
Microsoft.Identity.Client
Assembly:
Microsoft.Identity.Client.dll
Pacchetto:
Microsoft.Identity.Client v4.91.0

Tipo di eccezione di base generato quando si verifica un errore durante l'acquisizione del token. Per informazioni dettagliate, vedi https://aka.ms/msal-net-exceptions

public class MsalException : Exception
type MsalException = class
    inherit Exception
Public Class MsalException
Inherits Exception
Ereditarietà
Exception
MsalException
Derivato

Commenti

Evitare di generare questa eccezione. Generare invece il più specializzato MsalClientException o MsalServiceException

Costruttori

Nome Descrizione
MsalException()

Inizializza una nuova istanza della classe di eccezione.
MsalException(String, String, Exception)

Inizializza una nuova istanza della classe di eccezione con un codice di errore specificato e un riferimento all'eccezione interna che è la causa di questa eccezione.
MsalException(String, String)

Inizializza una nuova istanza della classe di eccezione con un codice di errore e un messaggio di errore specificati.
MsalException(String)

Inizializza una nuova istanza della classe di eccezione con un codice di errore specificato.

Campi

Nome Descrizione
AuthenticationResultMetadataKey

Chiave in Data cui MSAL archivia l'oggetto AuthenticationResultMetadata acquisito quando un'acquisizione di token ha esito negativo con un valore diversoMsalException da . Consente ai consumer downstream di eseguire la diagnostica dell'acquisizione di token anche se l'eccezione di origine viene generata nuovamente invariata.
BrokerErrorCode

Una AdditionalExceptionData chiave di proprietà, disponibile quando si usano broker desktop.
BrokerErrorContext

Una AdditionalExceptionData chiave di proprietà, disponibile quando si usano broker desktop.
BrokerErrorStatus

Una AdditionalExceptionData chiave di proprietà, disponibile quando si usano broker desktop.
BrokerErrorTag

Una AdditionalExceptionData chiave di proprietà, disponibile quando si usano broker desktop.
BrokerTelemetry

Una AdditionalExceptionData chiave di proprietà, disponibile quando si usano broker desktop.
ManagedIdentitySource

Una AdditionalExceptionData chiave di proprietà, disponibile quando si usa l'identità gestita.

Proprietà

Nome Descrizione
AdditionalExceptionData

Contenitore delle proprietà con dettagli aggiuntivi per questa eccezione.
AuthenticationResultMetadata

Metadati di diagnostica per il tentativo di acquisizione di token non riuscito, ovvero la durata totale e, quando la fase pertinente è stata eseguita, le durate HTTP/cache, l'endpoint del token e l'area usata. Si tratta di null quando l'eccezione è stata generata prima che la pipeline della richiesta inizi a raccogliere i metadati( ad esempio, la convalida del parametro o del generatore). Quando è diverso da Null, il tipico errore nella richiesta, DurationTotalInMs viene sempre popolato (utile per la misurazione della latenza), mentre gli altri campi possono essere 0/null quando la fase corrispondente non è stata eseguita. In caso di errore TokenSource non ha un valore significativo e non deve essere considerato attendibile. Riutilizza il tipo restituito da AuthenticationResultMetadata nel percorso di esito positivo.
CorrelationId

ID che può essere usato per suddividere un singolo flusso di autenticazione.
ErrorCode

Ottiene il codice di errore del protocollo restituito dal servizio o generato dal client. Si tratta del codice su cui è possibile fare affidamento per la gestione delle eccezioni. I valori per questo codice vengono in genere forniti in stringhe costanti nei tipi di eccezioni derivate con spiegazioni della mitigazione.
IsRetryable

Indica se l'operazione precedente che ha generato questa eccezione deve essere ritentata.

Metodi

Nome Descrizione
FromJsonString(String)

Consente la riattivazione dell'eccezione MsalException (o uno dei relativi tipi derivati) da JSON generato da ToJsonString().
ToJsonString()

Consente la serializzazione della maggior parte dei valori dell'eccezione in JSON.
ToString()

Crea e restituisce una rappresentazione di stringa dell'eccezione corrente.

Si applica a