Language

ObjectCache.GetValues Method

Definition

Namespace:
System.Runtime.Caching
Assembly:
System.Runtime.Caching.dll
Package:
System.Runtime.Caching v11.0.0-rc.1.26425.128

Gets a set of cache entries.

Overloads

Name Description
GetValues(IEnumerable, String)

When overridden in a derived class, gets a set of cache entries that correspond to the specified keys.
GetValues(String, String[])

Gets a set of cache entries that correspond to the specified keys.

GetValues(IEnumerable, String)

Source:
ObjectCache.cs
Source:
ObjectCache.cs
Source:
ObjectCache.cs
Source:
ObjectCache.cs

When overridden in a derived class, gets a set of cache entries that correspond to the specified keys.

public abstract System.Collections.Generic.IDictionary GetValues(System.Collections.Generic.IEnumerable keys, string regionName = default);
abstract member GetValues : seq * string -> System.Collections.Generic.IDictionary
Public MustOverride Function GetValues (keys As IEnumerable(Of String), Optional regionName As String = Nothing) As IDictionary(Of String, Object)

Parameters

keys
IEnumerable<String>

A collection of unique identifiers for the cache entries to get.

regionName
String

Optional. A named region in the cache to which the cache entry or entries were added, if regions are implemented. The default value for the optional parameter is null.

Returns

IDictionary<String,Object>

A dictionary of key/value pairs that represent cache entries.

Remarks

The GetValues(IEnumerable, String) method overload is a performance optimization for distributed caches that support fetching multiple cache entries from the cache during a single network call.

Although a caller can pass one or more keys to the method, there is no guarantee that all keys represent entries in the cache. Therefore, the returned dictionary might contain fewer items than the number of keys that were passed to the method.

Applies to

GetValues(String, String[])

Source:
ObjectCache.cs
Source:
ObjectCache.cs
Source:
ObjectCache.cs
Source:
ObjectCache.cs

Gets a set of cache entries that correspond to the specified keys.

public:
 virtual System::Collections::Generic::IDictionary ^ GetValues(System::String ^ regionName, ... cli::array  ^ keys);
public virtual System.Collections.Generic.IDictionary GetValues(string regionName, params string[] keys);
abstract member GetValues : string * string[] -> System.Collections.Generic.IDictionary
override this.GetValues : string * string[] -> System.Collections.Generic.IDictionary
Public Overridable Function GetValues (regionName As String, ParamArray keys As String()) As IDictionary(Of String, Object)

Parameters

regionName
String

Optional. A named region in the cache to which the cache entry or entries were added, if regions are implemented. Because regions are not implemented in .NET Framework 4, the default is null.

keys
String[]

A collection of unique identifiers for the cache entries to get.

Returns

IDictionary<String,Object>

A dictionary of key/value pairs that represent cache entries.

Remarks

The ObjectCache.GetValues method overload is like the GetValues(IEnumerable, String) method overload, but lets you pass the named region by using optional parameter syntax that is supported by managed languages such as C#.

This method is a virtual method because the ObjectCache class provides a default implementation that passes the params array to the GetValues(IEnumerable, String) method overload.

Applies to