MsalServiceException Klasa

Definicja

Przestrzeń nazw:: Microsoft.Identity.Client

Zestaw:: Microsoft.Identity.Client.dll

Pakiet:: Microsoft.Identity.Client v4.91.0

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Typ wyjątku zgłaszany, gdy usługa zwraca odpowiedź o błędzie lub wystąpią inne błędy sieciowe. Aby uzyskać więcej informacji, zobacz https://aka.ms/msal-net-exceptions

public class MsalServiceException : Microsoft.Identity.Client.MsalException

type MsalServiceException = class
    inherit MsalException

Public Class MsalServiceException
Inherits MsalException

Dziedziczenie: Exception

MsalException
MsalServiceException

Pochodne: Microsoft.Identity.Client.IntuneAppProtectionPolicyRequiredException

Microsoft.Identity.Client.MsalManagedIdentityException

Microsoft.Identity.Client.MsalThrottledServiceException

Microsoft.Identity.Client.MsalUiRequiredException

Konstruktory

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

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. (Odziedziczone po MsalException)
BrokerErrorCode	AdditionalExceptionData Klucz właściwości dostępny podczas korzystania z brokerów klasycznych. (Odziedziczone po MsalException)
BrokerErrorContext	AdditionalExceptionData Klucz właściwości dostępny podczas korzystania z brokerów klasycznych. (Odziedziczone po MsalException)
BrokerErrorStatus	AdditionalExceptionData Klucz właściwości dostępny podczas korzystania z brokerów klasycznych. (Odziedziczone po MsalException)
BrokerErrorTag	AdditionalExceptionData Klucz właściwości dostępny podczas korzystania z brokerów klasycznych. (Odziedziczone po MsalException)
BrokerTelemetry	AdditionalExceptionData Klucz właściwości dostępny podczas korzystania z brokerów klasycznych. (Odziedziczone po MsalException)
ManagedIdentitySource	AdditionalExceptionData Klucz właściwości dostępny podczas korzystania z tożsamości zarządzanej. (Odziedziczone po MsalException)

Właściwości

Nazwisko	Opis
AdditionalExceptionData	Torba właściwości z dodatkowymi szczegółami dla tego wyjątku. (Odziedziczone po MsalException)
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. (Odziedziczone po MsalException)
Claims	Dodatkowe oświadczenia żądane przez usługę. Jeśli ta właściwość nie ma wartości null lub jest pusta, oznacza to, że usługa wymaga od użytkownika podania dodatkowych oświadczeń, takich jak przeprowadzenie uwierzytelniania dwuskładnikowego. Oto dwa przypadki: Jeśli aplikacja jest elementem , należy wywołać metodę IPublicClientApplication AcquireTokenInteractive(IEnumerable<String>)WithClaims(String) i dodać modyfikator. Jeśli aplikacja jest elementem IConfidentialClientApplication, (w związku z tym wykonuje przepływ on-Behalf-Of), należy zgłosić wyjątek nieautoryzowany HTTP z komunikatem zawierającym oświadczenia Aby uzyskać więcej informacji, zobacz https://aka.ms/msal-net-claim-challenge
CorrelationId	Identyfikator, który może służyć do tworzenia pojedynczego przepływu uwierzytelniania. (Odziedziczone po MsalException)
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. (Odziedziczone po MsalException)
ErrorCodesForLogging	Lista kodów błędów specyficznych dla usługi STS zwracanych przez usługę tokenu (na przykład kody liczbowe `AADSTS` , takie jak `50076`, `50079`), które uściśliją ErrorCodeelement . Wartości są emitowane przez usługę i mogą ulec zmianie bez powiadomienia; przeznaczone do diagnostyki i rejestrowania — nie należy rozgałęziać zachowania produkcyjnego dla tej wartości. Zwraca wartość `null` , gdy usługa nie podała kodów błędów.
Headers	Zawiera nagłówki HTTP z odpowiedzi serwera, które wskazywały błąd.
IsRetryable	Wskazuje, czy poprzednia operacja, która spowodowała ten wyjątek, powinna zostać ponowiona. (Odziedziczone po MsalException)
ResponseBody	Nieprzetworzona treść odpowiedzi odebrana z serwera.
StatusCode	Pobiera kod stanu zwrócony z warstwy HTTP. Ten kod stanu jest `HttpStatusCode` w wewnętrznej HttpRequestException odpowiedzi lub w kodzie stanu zdarzenia NavigateError w przepływie opartym na przeglądarce (zobacz NavigateError Event Status Codes). Możesz użyć tego kodu do celów, takich jak implementowanie logiki ponawiania prób lub badania błędów.
SubErrorForLogging	Błąd podrzędny zwrócony przez udoskonalenie ErrorCode usługi tokenu (na przykład `consent_required`, `bad_token`, `protection_policy_required`). Wartości są emitowane przez usługę i mogą ulec zmianie bez powiadomienia; przeznaczone do diagnostyki i rejestrowania — nie należy rozgałęziać zachowania produkcyjnego dla tej wartości.

Metody

Nazwisko	Opis
ToJsonString()	Umożliwia serializacji większości wartości wyjątku w formacie JSON. (Odziedziczone po MsalException)
ToString()	Tworzy i zwraca reprezentację ciągu bieżącego wyjątku.
UpdateIsRetryable()	Zgodnie z dyskusją z Evo, AAD

Dotyczy

Opinia

Czy ta strona była pomocna?