Прочитать на английском

Поделиться через


ObjectCache.GetValues Метод

Определение

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Получает набор записей кэша.

Перегрузки

GetValues(IEnumerable<String>, String)

При переопределении в производном классе получает набор записей кэша, соответствующих указанным ключам.

GetValues(String, String[])

Получает набор записей кэша, соответствующих указанным ключам.

GetValues(IEnumerable<String>, String)

Исходный код:
ObjectCache.cs
Исходный код:
ObjectCache.cs
Исходный код:
ObjectCache.cs

При переопределении в производном классе получает набор записей кэша, соответствующих указанным ключам.

C#
public abstract System.Collections.Generic.IDictionary<string,object> GetValues(System.Collections.Generic.IEnumerable<string> keys, string regionName = default);

Параметры

keys
IEnumerable<String>

Коллекция уникальных идентификаторов записей кэша, которые необходимо получить.

regionName
String

Необязательный элемент. Именованная область кэша, в которую были добавлены одна или несколько записей кэша, если области реализованы. Значение необязательного параметра по умолчанию — null.

Возвращаемое значение

Словарь пар "ключ-значение", представляющих записи кэша.

Комментарии

Перегрузка GetValues(IEnumerable<String>, String) метода — это оптимизация производительности распределенных кэшей, которые поддерживают получение нескольких записей кэша из кэша во время одного сетевого вызова.

Хотя вызывающий объект может передать один или несколько ключей в метод, нет никакой гарантии, что все ключи представляют записи в кэше. Таким образом, возвращенный словарь может содержать меньше элементов, чем количество ключей, переданных методу .

Применяется к

.NET 10 (package-provided) и другие версии
Продукт Версии
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)

GetValues(String, String[])

Исходный код:
ObjectCache.cs
Исходный код:
ObjectCache.cs
Исходный код:
ObjectCache.cs

Получает набор записей кэша, соответствующих указанным ключам.

C#
public virtual System.Collections.Generic.IDictionary<string,object> GetValues(string regionName, params string[] keys);

Параметры

regionName
String

Необязательный элемент. Именованная область кэша, в которую были добавлены одна или несколько записей кэша, если области реализованы. Так как регионы не реализованы в платформа .NET Framework 4, по умолчанию используется значение null.

keys
String[]

Коллекция уникальных идентификаторов записей кэша, которые необходимо получить.

Возвращаемое значение

Словарь пар "ключ-значение", представляющих записи кэша.

Комментарии

Перегрузка ObjectCache.GetValues метода похожа на перегрузку GetValues(IEnumerable<String>, String) метода, но позволяет передать именованный регион с помощью необязательного синтаксиса параметров, поддерживаемого управляемыми языками, такими как C#.

Этот метод является виртуальным, так как ObjectCache класс предоставляет реализацию по умолчанию, которая передает params массив перегрузке GetValues(IEnumerable<String>, String) метода.

Применяется к

.NET 10 (package-provided) и другие версии
Продукт Версии
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)