DataCache.BulkGet 메서드

아티클
01/26/2011

지정된 캐시 영역으로부터 지정된 키의 개체를 반환합니다.

네임스페이스: Microsoft.ApplicationServer.Caching
어셈블리: Microsoft.ApplicationServer.Caching.Client(위치: microsoft.applicationserver.caching.client.dll)

사용

구문

‘선언
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>>

매개 변수

keys
검색할 개체의 키 목록은 null일 수 없습니다.

region
영역의 이름은 null일 수 없습니다.

반환 값

키와 값의 쌍 목록과 함께 IEnumerable 개체를 반환합니다.

설명

매개 변수 유효성 검사 동작:

키 또는 영역 매개 변수가 null이거나 키 목록에 null인 키가 있는 경우 BulkGet에서는 null 매개 변수에 대한 System.ArgumentNullException 개체를 반환합니다.
지정된 영역이 없을 경우 BulkGet에서는 null인 IEnumerable 개체를 반환합니다.
영역에 키가 없을 경우 열거자는 키에 대해 null 개체를 반환합니다. 예를 들어, 반환되는 키/값 쌍은 <key, null>입니다.

성능 고려 사항 - BulkGet은 작은 개체에 대해 사용할 때, 가령 크기가 1 - 5KB 이하인 여러 개체를 검색할 때 성능이 향상됩니다. BulkGet을 사용하여 큰 개체를 검색할 경우(예: 64KB를 초과하는 개체) 성능이 크게 향상되지 않으며 오히려 성능에 부정적으로 작용할 수도 있습니다. 큰 개체 힙을 사용하지 않도록 큰 대량 get 응답이 여러 개의 단일 개체 응답으로 분할되기 때문에 성능이 저하될 수 있습니다.

스레드 보안

이 유형의 public static(Visual Basic의Shared) 구성원은 모두 스레드가 안전합니다. 모든 인스턴스 구성원이 스레드가 안전한 것은 아닙니다.

플랫폼

개발 플랫폼

Visual Studio 2010 이상, .NET Framework 4

대상 플랫폼

Windows 7; Windows Server 2008 R2; Windows Server 2008 서비스 팩 2; Windows Vista 서비스 팩 2

참고 항목

참조 항목

DataCache 클래스
DataCache 구성원
Microsoft.ApplicationServer.Caching 네임스페이스

다음을 통해 공유