Metodo DataCache.BulkGet

Articolo
01/26/2011

Restituisce oggetti per le chiavi specificate dall'area della cache specificata.

Spazio dei nomi: Microsoft.ApplicationServer.Caching
Assembly: Microsoft.ApplicationServer.Caching.Client (in microsoft.applicationserver.caching.client.dll)

Uso

Sintassi

'Dichiarazione
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>>

Parametri

keys
Elenco di chiavi per gli oggetti da recuperare. Non può essere null.

region
Nome dell'area. Non può essere null.

Valore restituito

Restituisce un oggetto IEnumerable con un elenco di coppie chiave/valore.

Osservazioni

Logica di convalida dei parametri:

Se i parametri key o region sono null, o se una chiave dell'elenco delle chiavi è null, BulkGet genera un oggetto System.ArgumentNullException per il parametro null.
Se l'area specificata non è presente, BulkGet restituisce un oggetto IEnumerable null.
Se una chiave non è presente nell'area, l'oggetto restituito dall'enumeratore per la chiave è null. A esempio, la coppia chiave valore restituita sarebbe <key,null>.

Considerazioni sulle prestazioni - BulkGet migliora le prestazioni quando è utilizzato con oggetti di dimensioni ridotte, ad esempio durante il recupero di diversi oggetti di dimensioni pari o inferiori a 1 - 5 KB. Se utilizzato durante il recupero di oggetti di grandi dimensioni, ad esempio superiori a 64 KB, BulkGet non migliorerà le prestazioni; al contrario, potrebbe avere un impatto negativo su di esse. Il deterioramento delle prestazioni può verificarsi perché risposte a richieste get in blocco di grandi dimensioni vengono suddivise in più risposte con oggetti singoli allo scopo di evitare l'utilizzo dell'heap degli oggetti di grandi dimensioni.

Protezione thread

Qualsiasi membro statico (condiviso in Visual Basic) di questo tipo è thread safe, diversamente dai membri istanza.

Piattaforme

Piattaforme di sviluppo

Visual Studio 2010 e versioni successive, .NET Framework 4

Piattaforme di destinazione

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

Vedere anche

Informazioni di riferimento

Classe DataCache
DataCache membri
Spazio dei nomi Microsoft.ApplicationServer.Caching

Condividi tramite