DistributedCacheExtensions.GetStringAsync Methode

Definition

Ruft eine Zeichenfolge aus dem angegebenen Cache mit dem angegebenen Schlüssel asynchron ab.

C#
public static System.Threading.Tasks.Task<string?> GetStringAsync(this Microsoft.Extensions.Caching.Distributed.IDistributedCache cache, string key, System.Threading.CancellationToken token = default);

Parameter

cache
IDistributedCache

Der Cache, in dem die Daten gespeichert werden sollen.

key
String

Der Schlüssel, für den die gespeicherten Daten abgerufen werden sollen.

token
CancellationToken

Dies ist optional. Ein CancellationToken, um den Vorgang abzubrechen.

Gibt zurück

Eine Aufgabe zum Abrufen der Zeichenfolgenwert aus dem gespeicherten Cacheschlüssel.

Ausnahmen

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten GetString(IDistributedCache, String)Ausnahmen.

Gilt für:

Produkt Versionen
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Standard 2.0 (package-provided)