DataCache.Add 메서드 (String, Object, TimeSpan, 제네릭 IEnumerable)

아티클
01/26/2011

캐시에 개체를 추가합니다. 이 메서드는 태그를 캐시된 개체와 연결하고 개체 만료 시점을 지정할 수 있게 합니다.

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

사용

구문

‘선언
Public Function Add ( _
    key As String, _
    value As Object, _
    timeout As TimeSpan, _
    tags As IEnumerable(Of DataCacheTag) _
) As DataCacheItemVersion

public DataCacheItemVersion Add (
    string key,
    Object value,
    TimeSpan timeout,
    IEnumerable<DataCacheTag> tags
)

public:
DataCacheItemVersion^ Add (
    String^ key, 
    Object^ value, 
    TimeSpan timeout, 
    IEnumerable<DataCacheTag^>^ tags
)

public DataCacheItemVersion Add (
    String key, 
    Object value, 
    TimeSpan timeout, 
    IEnumerable<DataCacheTag> tags
)

public function Add (
    key : String, 
    value : Object, 
    timeout : TimeSpan, 
    tags : IEnumerable<DataCacheTag>
) : DataCacheItemVersion

매개 변수

key
캐시의 개체를 저장하고 검색할 때 사용되는 고유한 값입니다.

value
캐시 클러스터에 저장된 개체입니다.

timeout
개체가 만료되기 전에 캐시에 상주하는 시간입니다.

tags
캐시된 개체와 연결할 DataCacheTag 개체의 배열입니다.

반환 값

키 값과 함께 캐시에 저장된 개체의 버전을 나타내는 DataCacheItemVersion 개체입니다.

설명

동일한 키를 사용하는 항목이 이미 캐시에 있을 경우, 이 개체를 호출하면 DataCacheException 유형의 예외가 발생합니다. 이때 ErrorCode는 KeyAlreadyExists로 설정됩니다.

캐시된 개체가 영역에 저장된 경우에 한해 해당 개체 검색에 태그를 사용할 수 있습니다. 이 오버로드는 영역에 개체를 저장하지 않습니다.

캐시된 개체와 연결된 시간 제한 값은 명명된 캐시 구성에 지정된 만료 설정을 다시 정의합니다. 자세한 내용은 만료 및 제거를 참조하십시오. 이 메서드를 사용하는 방법에 대한 자세한 내용은 방법: 캐시에 개체 추가를 참조하십시오.

스레드 보안

이 유형의 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 네임스페이스

다음을 통해 공유