Język

MsalException Klasa

Definicja

Przestrzeń nazw:
Microsoft.Identity.Client
Zestaw:
Microsoft.Identity.Client.dll
Pakiet:
Microsoft.Identity.Client v4.91.0

Typ wyjątku podstawowego zgłaszany, gdy wystąpi błąd podczas pozyskiwania tokenu. Aby uzyskać więcej informacji, zobacz https://aka.ms/msal-net-exceptions

public class MsalException : Exception
type MsalException = class
    inherit Exception
Public Class MsalException
Inherits Exception
Dziedziczenie
Exception
MsalException
Pochodne

Uwagi

Unikaj zgłaszania tego wyjątku. Zamiast tego rzucaj bardziej wyspecjalizowane MsalClientException lub MsalServiceException

Konstruktory

Nazwisko Opis
MsalException()

Inicjuje nowe wystąpienie klasy wyjątku.
MsalException(String, String, Exception)

Inicjuje nowe wystąpienie klasy wyjątków z określonym kodem błędu i odwołaniem do wyjątku wewnętrznego, który jest przyczyną tego wyjątku.
MsalException(String, String)

Inicjuje nowe wystąpienie klasy wyjątków z określonym kodem błędu i komunikatem o błędzie.
MsalException(String)

Inicjuje nowe wystąpienie klasy wyjątków z określonym kodem błędu.

Pola

Nazwisko Opis
AuthenticationResultMetadataKey

Klucz, w Data którym biblioteka MSAL przechowuje przechwycone dane, gdy pozyskiwanie AuthenticationResultMetadata tokenu kończy się niepowodzeniem, a nieMsalException. Umożliwia konsumentom podrzędnym uzyskiwanie tokenu diagnostyki, mimo że wyjątek źródłowy zostanie ponownie zgłoszony bez zmian.
BrokerErrorCode

AdditionalExceptionData Klucz właściwości dostępny podczas korzystania z brokerów klasycznych.
BrokerErrorContext

AdditionalExceptionData Klucz właściwości dostępny podczas korzystania z brokerów klasycznych.
BrokerErrorStatus

AdditionalExceptionData Klucz właściwości dostępny podczas korzystania z brokerów klasycznych.
BrokerErrorTag

AdditionalExceptionData Klucz właściwości dostępny podczas korzystania z brokerów klasycznych.
BrokerTelemetry

AdditionalExceptionData Klucz właściwości dostępny podczas korzystania z brokerów klasycznych.
ManagedIdentitySource

AdditionalExceptionData Klucz właściwości dostępny podczas korzystania z tożsamości zarządzanej.

Właściwości

Nazwisko Opis
AdditionalExceptionData

Torba właściwości z dodatkowymi szczegółami dla tego wyjątku.
AuthenticationResultMetadata

Metadane diagnostyczne dla nieudanej próby uzyskania tokenu — łączny czas trwania i czas trwania odpowiedniego etapu, czas trwania http/pamięci podręcznej, punkt końcowy tokenu i używany region. Dzieje się tak null , gdy wyjątek został zgłoszony przed rozpoczęciem zbierania metadanych przez potok żądania (na przykład weryfikacji parametru lub konstruktora). Gdy jest to błąd inny niż null — typowy błąd w żądaniu — DurationTotalInMs jest zawsze wypełniany (przydatny do pomiaru opóźnienia), podczas gdy inne pola mogą mieć wartość 0/null, gdy odpowiedni etap nie został uruchomiony. Na awarii TokenSource nie ma znaczącej wartości i nie należy polegać na. Ponownie używa typu zwracanego AuthenticationResultMetadata przez w ścieżce powodzenia.
CorrelationId

Identyfikator, który może służyć do tworzenia pojedynczego przepływu uwierzytelniania.
ErrorCode

Pobiera kod błędu protokołu zwrócony przez usługę lub generowany przez klienta. Jest to kod, na którym można polegać na obsłudze wyjątków. Wartości dla tego kodu są zwykle udostępniane w ciągach stałych w typach wyjątków pochodnych z wyjaśnieniami ograniczania ryzyka.
IsRetryable

Wskazuje, czy poprzednia operacja, która spowodowała ten wyjątek, powinna zostać ponowiona.

Metody

Nazwisko Opis
FromJsonString(String)

Umożliwia ponowne nawodnienie msalException (lub jednego z jego typów pochodnych) z formatu JSON wygenerowanego przez toJsonString().
ToJsonString()

Umożliwia serializacji większości wartości wyjątku w formacie JSON.
ToString()

Tworzy i zwraca reprezentację ciągu bieżącego wyjątku.

Dotyczy