Método de DataCache.BulkGet

Devuelve objetos para las claves especificadas de la región especificada de la memoria caché.

Espacio de nombres: Microsoft.ApplicationServer.Caching
Ensamblado: Microsoft.ApplicationServer.Caching.Client (en microsoft.applicationserver.caching.client.dll)

Uso

Sintaxis

'Declaración
Public Function BulkGet ( _
    keys As IEnumerable(Of String), _
    region As String _
) As IEnumerable(Of KeyValuePair(Of String, Object))

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

public:
IEnumerable<KeyValuePair<String^, Object^>>^ BulkGet (
    IEnumerable<String^>^ keys, 
    String^ region
)

public IEnumerable<KeyValuePair<String,Object>> BulkGet (
    IEnumerable<String> keys, 
    String region
)

public function BulkGet (
    keys : IEnumerable<String>, 
    region : String
) : IEnumerable<KeyValuePair<String,Object>>

Parámetros

• keys
  Lista de claves para los objetos que se deben recuperar, no puede ser nulo.

• region
  Nombre de la región, no puede ser nulo.

Valor devuelto

Devuelve un objeto IEnumerable con una lista de pares de clave y valor.

Comentarios

Comportamiento de la validación de parámetros:

• Si el parámetro de claves o región es nulo, o alguna clave de la lista de claves es nula, BulkGet emitirá un objeto System.ArgumentNullException para el parámetro nulo.

• Si la región especificada no está presente, BulkGet devolverá un objeto IEnumerable nulo.

• Si una clave no está presente en la región, el objeto devuelto por el enumerador de la clave será nulo. Por ejemplo, el par clave/valor devuelto sería <clave,nulo>.

Consideraciones sobre el rendimiento: BulkGet mejora el rendimiento cuando se usa con objetos pequeños, por ejemplo, al recuperar muchos objetos con un tamaño de 1 a 5 KB o inferior. Cuando se usa BulkGet para recuperar objetos grandes, por ejemplo, objetos superiores a 64 KB, BulkGet no mejorará significativamente el rendimiento y, de hecho, puede afectarle negativamente. Esta reducción del rendimiento puede producirse porque las respuestas de bulk get grandes se dividen en varias respuestas de un único objeto para evitar el uso de un montón de objetos grandes.

Seguridad para subprocesos

Todos los miembros públicos y estáticos (Shared en Visual Basic) de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Plataformas

Plataformas de desarrollo

Visual Studio 2010 y posterior, .NET Framework 4

Plataformas de destino

Windows 7; Windows Server 2008 R2; Windows Server 2008 Service Pack 2; Windows Vista Service Pack 2

Vea también

Referencia

Clase de DataCache
Miembros de DataCache
Espacio de nombres de Microsoft.ApplicationServer.Caching