ITokenCache Interfaz
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Esta es la interfaz que implementa el acceso público a las operaciones de caché. Con CacheV2, esto solo debe ser necesario si el autor de la llamada conserva la memoria caché en su propio almacén, ya que esto proporcionará la serialización o deserialización y antes y después de las notificaciones usadas en ese escenario. Vea https://aka.ms/aka.ms/msal-net-token-cache-serialization.
public interface ITokenCachetype ITokenCache = interfacePublic Interface ITokenCache- Derivado
Métodos
| Nombre | Description |
|---|---|
| SetAfterAccess(TokenCacheCallback) |
Establece un delegado que se notificará después de que cualquier método de biblioteca acceda a la memoria caché. Esto proporciona una opción al delegado para serializar una entrada de caché para la aplicación y las cuentas especificadas en TokenCacheNotificationArgs. Consulte https://aka.ms/msal-net-token-cache-serialization. Si necesita devoluciones de llamada asincrónicas o basadas en tareas, use SetAfterAccessAsync en su lugar. |
| SetAfterAccessAsync(Func<TokenCacheNotificationArgs,Task>) |
Establece un delegado que se notificará después de que cualquier método de biblioteca acceda a la memoria caché. Esto proporciona una opción al delegado para serializar una entrada de caché para la aplicación y las cuentas especificadas en TokenCacheNotificationArgs. Consulte https://aka.ms/msal-net-token-cache-serialization. Esto proporciona la misma funcionalidad que SetAfterAccess, pero proporciona una devolución de llamada asincrónica o basada en tareas. |
| SetBeforeAccess(TokenCacheCallback) |
Establece un delegado que se notificará antes de que cualquier método de biblioteca acceda a la memoria caché. Esto proporciona una opción al delegado para deserializar una entrada de caché para la aplicación y las cuentas especificadas en TokenCacheNotificationArgs. Consulte https://aka.ms/msal-net-token-cache-serialization. Si necesita devoluciones de llamada asincrónicas o basadas en tareas, use SetBeforeAccessAsync en su lugar. |
| SetBeforeAccessAsync(Func<TokenCacheNotificationArgs,Task>) |
Establece un delegado que se notificará antes de que cualquier método de biblioteca acceda a la memoria caché. Esto proporciona una opción al delegado para deserializar una entrada de caché para la aplicación y las cuentas especificadas en TokenCacheNotificationArgs. Consulte https://aka.ms/msal-net-token-cache-serialization. Esto proporciona la misma funcionalidad que SetBeforeAccess, pero proporciona una devolución de llamada asincrónica o basada en tareas. |
| SetBeforeWrite(TokenCacheCallback) |
Establece un delegado llamado antes de que cualquier método de biblioteca escriba en la memoria caché. Esto ofrece una opción para que el delegado vuelva a cargar el estado de la caché desde una fila de la base de datos y bloquee esa fila. Después, esa fila de base de datos se puede desbloquear en el delegado registrado con SetAfterAccess(TokenCacheCallback) Si necesita devoluciones de llamada asincrónicas o basadas en tareas, use SetBeforeWriteAsync en su lugar. |
| SetBeforeWriteAsync(Func<TokenCacheNotificationArgs,Task>) |
Establece un delegado llamado antes de que cualquier método de biblioteca escriba en la memoria caché. Esto ofrece una opción para que el delegado vuelva a cargar el estado de la caché desde una fila de la base de datos y bloquee esa fila. Esa fila de base de datos se puede desbloquear en el delegado registrado con SetAfterAccess(TokenCacheCallback) Esto proporciona la misma funcionalidad que SetBeforeWrite, pero proporciona una devolución de llamada asincrónica o basada en tareas. |
Métodos de extensión
| Nombre | Description |
|---|---|
| SetCacheOptions(ITokenCache, CacheOptions) |
Opciones para las cachés de tokens de MSAL. MSAL mantiene una caché de tokens internamente en la memoria. De forma predeterminada, este objeto de caché forma parte de cada instancia de PublicClientApplication o ConfidentialClientApplication. Este método permite personalizar la caché de tokens en memoria de MSAL. La caché de memoria de MSAL es diferente de la serialización de caché de tokens. La serialización de caché extrae los tokens de una memoria caché (por ejemplo, Redis, Cosmos o un archivo en disco), donde se almacenan en formato JSON, en la caché de memoria interna de MSAL. Las operaciones de caché de memoria no implican operaciones JSON. La serialización de caché externa sigue siendo la manera recomendada de controlar las aplicaciones de escritorio, el sitio web y las API web, ya que proporciona persistencia. Estas opciones no controlan actualmente la serialización de caché externa. Instrucciones detalladas para cada tipo de aplicación y plataforma: https://aka.ms/msal-net-token-cache-serialization |