다음을 통해 공유


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

지정된 버전의 개체인 경우 지정된 영역에서 개체를 추가하거나 바꿉니다. 시간 제한 값을 지정하고 태그를 캐시된 개체와 연결합니다.

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

사용

구문

‘선언
Public Function Put ( _
    key As String, _
    value As Object, _
    oldVersion As DataCacheItemVersion, _
    timeout As TimeSpan, _
    tags As IEnumerable(Of DataCacheTag), _
    region As String _
) As DataCacheItemVersion
public DataCacheItemVersion Put (
    string key,
    Object value,
    DataCacheItemVersion oldVersion,
    TimeSpan timeout,
    IEnumerable<DataCacheTag> tags,
    string region
)
public:
DataCacheItemVersion^ Put (
    String^ key, 
    Object^ value, 
    DataCacheItemVersion^ oldVersion, 
    TimeSpan timeout, 
    IEnumerable<DataCacheTag^>^ tags, 
    String^ region
)
public DataCacheItemVersion Put (
    String key, 
    Object value, 
    DataCacheItemVersion oldVersion, 
    TimeSpan timeout, 
    IEnumerable<DataCacheTag> tags, 
    String region
)
public function Put (
    key : String, 
    value : Object, 
    oldVersion : DataCacheItemVersion, 
    timeout : TimeSpan, 
    tags : IEnumerable<DataCacheTag>, 
    region : String
) : DataCacheItemVersion

매개 변수

  • key
    영역에서 개체를 식별할 때 사용하는 고유한 값입니다.
  • value
    추가하거나 바꿀 개체입니다.
  • oldVersion
    바꿀 캐시된 개체의 버전을 나타내는 DataCacheItemVersion 개체입니다.
  • timeout
    개체가 만료되기 전에 캐시에 상주하는 시간입니다.
  • tags
    개체와 연결할 태그의 목록입니다.
  • region
    개체가 상주하는 영역의 이름입니다.

반환 값

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

설명

이 메서드에서는 oldVersion 매개 변수를 전달하여 동시성을 유지할 수 있습니다. 이 메서드가 호출되기 전에 다른 프로세스에서 캐시된 개체를 업데이트할 경우 이 메서드는 캐시된 개체를 업데이트하지 않으며 null을 반환합니다. 동시성에 대한 자세한 내용은 동시성 모델동시성 메서드를 참조하십시오.

이 오버로드는 개체와 연결된 태그를 업데이트하는 데 유용합니다. 태그 사용을 위해 제공되는 메서드에 대한 자세한 내용은 태그 기반 메서드를 참조하십시오.

캐시된 개체와 연결된 timeout 값은 명명된 캐시 구성에 지정된 만료 설정을 다시 정의합니다. 자세한 내용은 만료 및 제거를 참조하십시오.

이 메서드 사용에 대한 자세한 내용은 방법: 캐시에서 개체 업데이트를 참조하십시오.

스레드 보안

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