ITokenCache Interfaccia
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Si tratta dell'interfaccia che implementa l'accesso pubblico alle operazioni della cache. Con CacheV2, questa operazione deve essere necessaria solo se il chiamante rende persistente la cache nel proprio archivio, poiché in questo modo verranno fornite le notifiche di serializzazione/deserializzazione e prima/dopo usate in tale scenario. Fare riferimento a https://aka.ms/aka.ms/msal-net-token-cache-serialization
public interface ITokenCachetype ITokenCache = interfacePublic Interface ITokenCache- Derivato
Metodi
| Nome | Descrizione |
|---|---|
| SetAfterAccess(TokenCacheCallback) |
Imposta un delegato che deve ricevere una notifica dopo che qualsiasi metodo di libreria accede alla cache. Ciò consente al delegato di serializzare una voce della cache per l'applicazione e gli account specificati in TokenCacheNotificationArgs. Vedete https://aka.ms/msal-net-token-cache-serialization. Se sono necessari callback asincroni/basati su attività, usare invece SetAfterAccessAsync. |
| SetAfterAccessAsync(Func<TokenCacheNotificationArgs,Task>) |
Imposta un delegato che deve ricevere una notifica dopo che qualsiasi metodo di libreria accede alla cache. Ciò consente al delegato di serializzare una voce della cache per l'applicazione e gli account specificati in TokenCacheNotificationArgs. Vedete https://aka.ms/msal-net-token-cache-serialization. Fornisce la stessa funzionalità di SetAfterAccess, ma fornisce un callback asincrono/basato su attività. |
| SetBeforeAccess(TokenCacheCallback) |
Imposta un delegato che deve ricevere una notifica prima che qualsiasi metodo di libreria acceda alla cache. Ciò consente al delegato di deserializzare una voce della cache per l'applicazione e gli account specificati in TokenCacheNotificationArgs. Vedete https://aka.ms/msal-net-token-cache-serialization. Se sono necessari callback asincroni/basati su attività, usare invece SetBeforeAccessAsync. |
| SetBeforeAccessAsync(Func<TokenCacheNotificationArgs,Task>) |
Imposta un delegato che deve ricevere una notifica prima che qualsiasi metodo di libreria acceda alla cache. Ciò consente al delegato di deserializzare una voce della cache per l'applicazione e gli account specificati in TokenCacheNotificationArgs. Vedete https://aka.ms/msal-net-token-cache-serialization. Offre la stessa funzionalità di SetBeforeAccess, ma fornisce un callback asincrono/basato su attività. |
| SetBeforeWrite(TokenCacheCallback) |
Imposta un delegato chiamato prima che qualsiasi metodo di libreria scriva nella cache. In questo modo, il delegato può ricaricare lo stato della cache da una riga nel database e bloccare tale riga. La riga del database può quindi essere sbloccata nel delegato registrato con SetAfterAccess(TokenCacheCallback) Se sono necessari callback asincroni/basati su attività, usare invece SetBeforeWriteAsync. |
| SetBeforeWriteAsync(Func<TokenCacheNotificationArgs,Task>) |
Imposta un delegato chiamato prima che qualsiasi metodo di libreria scriva nella cache. In questo modo, il delegato può ricaricare lo stato della cache da una riga nel database e bloccare tale riga. La riga del database può quindi essere sbloccata nel delegato registrato con SetAfterAccess(TokenCacheCallback) Questa funzionalità fornisce la stessa funzionalità di SetBeforeWrite, ma fornisce un callback asincrono/basato su attività. |
Metodi di estensione
| Nome | Descrizione |
|---|---|
| SetCacheOptions(ITokenCache, CacheOptions) |
Opzioni per le cache dei token MSAL. MSAL gestisce una cache dei token internamente in memoria. Per impostazione predefinita, questo oggetto cache fa parte di ogni istanza di PublicClientApplication o ConfidentialClientApplication. Questo metodo consente la personalizzazione della cache dei token in memoria di MSAL. La cache di memoria di MSAL è diversa dalla serializzazione della cache dei token. La serializzazione della cache esegue il pull dei token da una cache (ad esempio Redis, Cosmos o un file su disco), in cui vengono archiviati in formato JSON, nella cache di memoria interna di MSAL. Le operazioni della cache di memoria non comportano operazioni JSON. La serializzazione della cache esterna rimane il modo consigliato per gestire app desktop, siti Web e API Web, in quanto fornisce la persistenza. Queste opzioni non controllano attualmente la serializzazione della cache esterna. Indicazioni dettagliate per ogni tipo di applicazione e piattaforma: https://aka.ms/msal-net-token-cache-serialization |