BulkGet Method (IEnumerable(String), String)

Returns objects for the specified keys from the specified region of the cache. Applies only to the server versions of AppFabric.

Namespace:  Microsoft.ApplicationServer.Caching
Assembly:  Microsoft.ApplicationServer.Caching.Client (in Microsoft.ApplicationServer.Caching.Client.dll)

public IEnumerable<KeyValuePair<string, Object>> BulkGet(
	IEnumerable<string> keys,
	string region


Type: System.Collections.Generic..::..IEnumerable<(Of <(<'String>)>)>
List of keys for the objects to retrieve, cannot be null.
Type: System..::..String
Name of the region, cannot be null.

Return Value

Type: System.Collections.Generic..::..IEnumerable<(Of <(<'KeyValuePair<(Of <(<'String, Object>)>)>>)>)>
Returns an IEnumerable<(Of <(<'T>)>)> object with a list of key and value pairs.

Parameter validation behavior:

  • If the specified region is not present, BulkGet will return a null IEnumerable object.

  • If a key is not present in the region, the object returned by the enumerator for the key will be null. For example, the key/value pair returned would be <key,null>.

Performance considerations - BulkGet improves performance when used with small objects, for example, when retrieving many objects of 1 - 5KB or less in size. When using BulkGet to retrieve large objects, for example objects larger than 64 KB, BulkGet will not significantly improve performance and in fact may adversely impact performance. This reduced performance can occur because large bulk get responses are split into multiple single object responses to avoid large object heap usage.