MsalException Klasse

Definition

Namespace:

Microsoft.Identity.Client

Assembly:

Microsoft.Identity.Client.dll

Paket:

Microsoft.Identity.Client v4.91.0

Der Basis exception type thrown when an error occurs during token acquisition. Weitere Einzelheiten finden Sie unter https://aka.ms/msal-net-exceptions

public class MsalException : Exception

type MsalException = class
    inherit Exception

Public Class MsalException
Inherits Exception

Vererbung

Exception

MsalException

Abgeleitet

Microsoft.Identity.Client.MsalClientException

Microsoft.Identity.Client.MsalServiceException

Hinweise

Vermeiden Sie das Auslösen dieser Ausnahme. Werfen Sie stattdessen die spezielleren MsalClientException oder MsalServiceException

Konstruktoren

Name	Beschreibung
MsalException()	Initialisiert eine neue Instanz der Ausnahmeklasse.
MsalException(String, String, Exception)	Initialisiert eine neue Instanz der Ausnahmeklasse mit einem angegebenen Fehlercode und einem Verweis auf die innere Ausnahme, die die Ursache dieser Ausnahme ist.
MsalException(String, String)	Initialisiert eine neue Instanz der Ausnahmeklasse mit einem angegebenen Fehlercode und einer Fehlermeldung.
MsalException(String)	Initialisiert eine neue Instanz der Ausnahmeklasse mit einem angegebenen Fehlercode.

Felder

Name	Beschreibung
AuthenticationResultMetadataKey	Ein Schlüssel, unter Data dem MSAL den AuthenticationResultMetadata erfassten Speicher speichert, wenn ein Tokenerwerb mit einem Nicht-FehlerMsalException auftritt. Ermöglicht nachgeschalteten Verbrauchern die Tokenakquisitionsdiagnose, auch wenn die ursprüngliche Ausnahme unverändert ausgelöst wird.
BrokerErrorCode	Ein AdditionalExceptionData Eigenschaftsschlüssel, der bei Verwendung von Desktopbrokern verfügbar ist.
BrokerErrorContext	Ein AdditionalExceptionData Eigenschaftsschlüssel, der bei Verwendung von Desktopbrokern verfügbar ist.
BrokerErrorStatus	Ein AdditionalExceptionData Eigenschaftsschlüssel, der bei Verwendung von Desktopbrokern verfügbar ist.
BrokerErrorTag	Ein AdditionalExceptionData Eigenschaftsschlüssel, der bei Verwendung von Desktopbrokern verfügbar ist.
BrokerTelemetry	Ein AdditionalExceptionData Eigenschaftsschlüssel, der bei Verwendung von Desktopbrokern verfügbar ist.
ManagedIdentitySource	Ein AdditionalExceptionData Eigenschaftsschlüssel, der bei Verwendung der verwalteten Identität verfügbar ist.

Eigenschaften

Name	Beschreibung
AdditionalExceptionData	Ein Eigenschaftenbehälter mit zusätzlichen Details für diese Ausnahme.
AuthenticationResultMetadata	Diagnosemetadaten für den fehlgeschlagenen Tokenakquisitionsversuch – die Gesamtdauer und, wenn die relevante Phase ausgeführt wurde, HTTP-/Cachedauern, Tokenendpunkt und Region verwendet. Dies ist null der Zeitpunkt, an dem die Ausnahme ausgelöst wurde, bevor die Anforderungspipeline mit dem Sammeln von Metadaten begonnen hat (z. B. Parameter- oder Generatorüberprüfung). Wenn es nicht null ist – der typische In-Request-Fehler – DurationTotalInMs immer aufgefüllt wird (nützlich für Latenzmessungen), während die anderen Felder 0/NULL sein können, wenn die entsprechende Phase nicht ausgeführt wurde. Bei einem Fehler TokenSource hat kein sinnvoller Wert und sollte nicht darauf vertrauen. Verwendet den Typ, der vom Erfolgspfad zurückgegeben wird AuthenticationResultMetadata .
CorrelationId	Eine ID, die verwendet werden kann, um einen einzelnen Authentifizierungsfluss zu erstellen.
ErrorCode	Ruft den Protokollfehlercode ab, der vom Dienst zurückgegeben oder vom Client generiert wird. Dies ist der Code, auf den Sie sich für die Ausnahmebehandlung verlassen können. Werte für diesen Code werden in der Regel in Konstantenzeichenfolgen in den abgeleiteten Ausnahmentypen mit Erläuterungen zur Entschärfung bereitgestellt.
IsRetryable	Gibt an, ob der vorherige Vorgang, der zu dieser Ausnahme führte, erneut überprüft werden soll.

Methoden

Name	Beschreibung
FromJsonString(String)	Ermöglicht die erneute Hydratation der MsalException (oder eines seiner abgeleiteten Typen) aus JSON, die von ToJsonString() generiert werden.
ToJsonString()	Ermöglicht die Serialisierung der meisten Werte der Ausnahme in JSON.
ToString()	Erstellt und gibt eine Zeichenfolgendarstellung der aktuellen Ausnahme zurück.