Język

ITokenCache Interfejs

Definicja

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

Jest to interfejs, który implementuje publiczny dostęp do operacji pamięci podręcznej. W przypadku pamięci podręcznej CacheV2 powinno to być konieczne tylko wtedy, gdy obiekt wywołujący utrwala pamięć podręczną we własnym magazynie, ponieważ zapewni to serializowanie/deserializowanie i przed/po powiadomieniach używanych w tym scenariuszu. Zobacz https://aka.ms/aka.ms/msal-net-token-cache-serialization

public interface ITokenCache
type ITokenCache = interface
Public Interface ITokenCache
Pochodne

Metody

Nazwisko Opis
SetAfterAccess(TokenCacheCallback)

Ustawia pełnomocnika, który ma być powiadamiany po jakichkolwiek metodach biblioteki uzyskuje dostęp do pamięci podręcznej. To przekazuje delegatowi możliwość zserializowania wpisu pamięci podręcznej dla aplikacji i kont określonych w TokenCacheNotificationArgs. Zobacz: https://aka.ms/msal-net-token-cache-serialization. Jeśli potrzebujesz wywołań zwrotnych opartych na asynchronicznych/zadaniach, zamiast tego użyj polecenia SetAfterAccessAsync.
SetAfterAccessAsync(Func<TokenCacheNotificationArgs,Task>)

Ustawia pełnomocnika, który ma być powiadamiany po jakichkolwiek metodach biblioteki uzyskuje dostęp do pamięci podręcznej. To przekazuje delegatowi możliwość zserializowania wpisu pamięci podręcznej dla aplikacji i kont określonych w TokenCacheNotificationArgs. Zobacz: https://aka.ms/msal-net-token-cache-serialization. Zapewnia to tę samą funkcjonalność co SetAfterAccess, ale zapewnia ona wywołanie zwrotne oparte na asynchronicznych/zadaniach.
SetBeforeAccess(TokenCacheCallback)

Ustawia pełnomocnika, który ma być powiadamiany przed uzyskaniem dostępu do pamięci podręcznej przez dowolną metodę biblioteki. To daje opcję dla delegata do deserializacji wpisu pamięci podręcznej dla aplikacji i kont wskazanych w pliku TokenCacheNotificationArgs. Zobacz: https://aka.ms/msal-net-token-cache-serialization. Jeśli potrzebujesz wywołań zwrotnych opartych na asynchronicznych/zadaniach, zamiast tego użyj polecenia SetBeforeAccessAsync.
SetBeforeAccessAsync(Func<TokenCacheNotificationArgs,Task>)

Ustawia pełnomocnika, który ma być powiadamiany przed uzyskaniem dostępu do pamięci podręcznej przez dowolną metodę biblioteki. To daje opcję dla delegata do deserializacji wpisu pamięci podręcznej dla aplikacji i kont wskazanych w pliku TokenCacheNotificationArgs. Zobacz: https://aka.ms/msal-net-token-cache-serialization. Zapewnia to tę samą funkcjonalność co SetBeforeAccess, ale zapewnia funkcję wywołania zwrotnego opartego na async/zadaniu.
SetBeforeWrite(TokenCacheCallback)

Ustawia delegata wywoływanego przed zapisaniem dowolnej metody biblioteki w pamięci podręcznej. Dzięki temu pełnomocnik może ponownie załadować stan pamięci podręcznej z wiersza w bazie danych i zablokować ten wiersz. Ten wiersz bazy danych można następnie odblokować w delegacie zarejestrowanym SetAfterAccess(TokenCacheCallback) za pomocą polecenia Jeśli potrzebujesz wywołań zwrotnych opartych na asynchronicznych/zadaniach, użyj polecenia SetBeforeWriteAsync.
SetBeforeWriteAsync(Func<TokenCacheNotificationArgs,Task>)

Ustawia delegata wywoływanego przed zapisaniem dowolnej metody biblioteki w pamięci podręcznej. Dzięki temu pełnomocnik może ponownie załadować stan pamięci podręcznej z wiersza w bazie danych i zablokować ten wiersz. Ten wiersz bazy danych można następnie odblokować w delegata zarejestrowanego za pomocą SetAfterAccess(TokenCacheCallback) polecenia To zapewnia taką samą funkcjonalność jak SetBeforeWrite, ale zapewnia ona wywołanie zwrotne oparte na asynchronicznych/zadaniach.

Metody rozszerzania

Nazwisko Opis
SetCacheOptions(ITokenCache, CacheOptions)

Opcje pamięci podręcznych tokenów biblioteki MSAL.

Biblioteka MSAL przechowuje pamięć podręczną tokenu wewnętrznie w pamięci. Domyślnie ten obiekt pamięci podręcznej jest częścią każdego wystąpienia klasy PublicClientApplication lub ConfidentialClientApplication. Ta metoda umożliwia dostosowanie pamięci podręcznej tokenu w pamięci biblioteki MSAL.

Pamięć podręczna biblioteki MSAL różni się od serializacji pamięci podręcznej tokenu. Serializacja pamięci podręcznej ściąga tokeny z pamięci podręcznej (np. Redis, Cosmos lub pliku na dysku), gdzie są przechowywane w formacie JSON, do wewnętrznej pamięci podręcznej biblioteki MSAL. Operacje pamięci podręcznej nie obejmują operacji JSON.

Serializacja zewnętrznej pamięci podręcznej pozostaje zalecanym sposobem obsługi aplikacji klasycznych, witryn internetowych i internetowych interfejsów API, ponieważ zapewnia trwałość. Te opcje nie kontrolują obecnie serializacji zewnętrznej pamięci podręcznej.

Szczegółowe wskazówki dotyczące poszczególnych typów i platform aplikacji: https://aka.ms/msal-net-token-cache-serialization

Dotyczy