Lenguaje

MsalException Clase

Definición

Tipo de excepción base que se produce cuando se produce un error durante la adquisición de tokens. Si desea obtener información más detallada, consulte https://aka.ms/msal-net-exceptions.

public class MsalException : Exception
type MsalException = class
    inherit Exception
Public Class MsalException
Inherits Exception
Herencia
MsalException
Derivado

Comentarios

Evite iniciar esta excepción. En su lugar, inicie el más especializado MsalClientException o MsalServiceException

Constructores

Nombre Description
MsalException()

Inicializa una nueva instancia de la clase de excepción.

MsalException(String, String, Exception)

Inicializa una nueva instancia de la clase de excepción con un código de error especificado y una referencia a la excepción interna que es la causa de esta excepción.

MsalException(String, String)

Inicializa una nueva instancia de la clase de excepción con un código de error y un mensaje de error especificados.

MsalException(String)

Inicializa una nueva instancia de la clase de excepción con un código de error especificado.

Campos

Nombre Description
AuthenticationResultMetadataKey

Clave en la Data que MSAL almacena el AuthenticationResultMetadata objeto capturado cuando se produce un error en la adquisición de tokens con un valorMsalException distinto. Permite a los consumidores de nivel inferior exponer los diagnósticos de adquisición de tokens aunque la excepción de origen se vuelva a producir sin cambios.

BrokerErrorCode

Una AdditionalExceptionData clave de propiedad, disponible cuando se usan agentes de escritorio.

BrokerErrorContext

Una AdditionalExceptionData clave de propiedad, disponible cuando se usan agentes de escritorio.

BrokerErrorStatus

Una AdditionalExceptionData clave de propiedad, disponible cuando se usan agentes de escritorio.

BrokerErrorTag

Una AdditionalExceptionData clave de propiedad, disponible cuando se usan agentes de escritorio.

BrokerTelemetry

Una AdditionalExceptionData clave de propiedad, disponible cuando se usan agentes de escritorio.

ManagedIdentitySource

Una AdditionalExceptionData clave de propiedad, disponible cuando se usa la identidad administrada.

Propiedades

Nombre Description
AdditionalExceptionData

Contenedor de propiedades con detalles adicionales para esta excepción.

AuthenticationResultMetadata

Metadatos de diagnóstico para el intento de adquisición de tokens con error: la duración total y, cuando se ejecutó la fase pertinente, duraciones http/caché, punto de conexión del token y región usadas. Esto es null cuando se produjo la excepción antes de que la canalización de solicitudes comenzara a recopilar metadatos (por ejemplo, parámetro o validación del generador). Cuando no es null , el error típico en la solicitud, DurationTotalInMs siempre se rellena (resulta útil para la medición de latencia), mientras que los demás campos pueden ser 0/NULL cuando no se ejecutó la fase correspondiente. En un error TokenSource no tiene ningún valor significativo y no debe basarse en . Reutiliza el tipo devuelto por AuthenticationResultMetadata en la ruta de acceso correcta.

CorrelationId

Identificador que se puede usar para dividir un único flujo de autenticación.

ErrorCode

Obtiene el código de error del protocolo devuelto por el servicio o generado por el cliente. Este es el código en el que puede confiar en el control de excepciones. Los valores de este código normalmente se proporcionan en cadenas constantes en los tipos de excepciones derivadas con explicaciones de mitigación.

IsRetryable

Indica si se debe reintentar la operación anterior que dio lugar a esta excepción.

Métodos

Nombre Description
FromJsonString(String)

Permite la rehidratación de MsalException (o uno de sus tipos derivados) de JSON generado por ToJsonString().

ToJsonString()

Permite la serialización de la mayoría de los valores de la excepción en JSON.

ToString()

Crea y devuelve una representación de cadena de la excepción actual.

Se aplica a