이 설명서는 보관되지만 유지 되지 않습니다.

방법: Azure 역할 내 캐시를 사용하도록 Visual Studio 준비

업데이트 날짜: 2015년 8월

Important중요
새로 시작하는 모든 개발 작업에서는 Azure Redis Cache를 사용하는 것이 좋습니다. Azure Cache 기능 선택에 대한 최신 설명서 및 지침은 내게 적합한 Azure 캐시 기능을 참조하세요.

이 항목에서는 Visual Studio를 사용하도록 Microsoft Azure 캐시 프로젝트를 준비하는 방법에 대해 설명합니다. 여기에는 다음 작업이 포함됩니다.

  • 올바른 버전의 .NET Framework가 대상으로 지정되어 있는지 확인합니다.

  • 캐싱 어셈블리를 참조합니다.

이러한 작업 후 web.config 파일 또는 응용 프로그램의 dataCacheClient 섹션에서 캐시 클라이언트를 구성할 수 있습니다. 이렇게 하면 Microsoft.ApplicationServer.Caching 네임스페이스에서 캐싱 메서드를 사용할 수 있습니다.

Warning경고
동일한 컴퓨터에 Windows Server용 Microsoft AppFabric 1.1과 Microsoft Azure 캐시를 함께 설치하면 안 됩니다. 여기에는 제품 및 SDK가 모두 포함됩니다. 전역 어셈블리 캐시의 일부 Windows Server용 Microsoft AppFabric 1.1 어셈블리를 잘못 참조하여 잘못된 동작이나 예기치 않은 동작이 발생할 수 있습니다.

  1. Visual Studio 프로젝트를 엽니다.

  2. 솔루션 탐색기에서 프로젝트 이름을 마우스 오른쪽 단추로 클릭한 다음 속성을 선택합니다.

  3. Visual C# 프로젝트의 경우에는 다음 단계를 사용합니다.

    1. 프로젝트 속성 대화 상자의 응용 프로그램 탭을 선택합니다.

    2. 대상 Framework 버전이 .NET Framework 2.0 이상(비 클라이언트 프로필)인지 확인합니다.

  4. Visual Basic 프로젝트의 경우에는 다음 단계를 사용합니다.

    1. 프로젝트 속성 페이지의 컴파일 섹션을 선택합니다.

    2. 컴파일 페이지 아래쪽의 고급 컴파일 옵션 단추를 클릭합니다.

    3. 대상 Framework 버전이 .NET Framework 2.0 이상(비 클라이언트 프로필)인지 확인합니다.

Important중요
대상 Framework 버전에 클라이언트 프로필을 사용하지 마세요. Visual Studio에서 "클라이언트 프로필"을 지정하지 않는 .NET Framework 버전을 선택하세요.

어셈블리 참조를 추가하려면 컴퓨터에 Azure SDK가 설치되어 있어야 합니다. 설치 지침은 Azure SDK 다운로드를 참조하세요.

다음 단계에서는 NuGet 패키지를 사용하여 필수 어셈블리 참조와 구성 변경 사항을 추가합니다. 이러한 단계는 동일한 배포의 역할 내 캐시 역할에서 호스팅되는 Azure를 사용하는 경우에만 적용됩니다.

  1. 솔루션 탐색기에서 프로젝트 이름을 마우스 오른쪽 단추로 클릭한 다음 라이브러리 패키지 참조 추가(NuGet 1.2) 또는 NuGet 패키지 관리(NuGet 2.0 이상)를 선택합니다.

  2. 왼쪽 창에서 온라인 범주를 선택합니다.

  3. WindowsAzure.Caching을 검색합니다.

  4. Microsoft.WindowsAzure.Caching(NuGet 1.2) 또는 Azure 캐싱(NuGet 2.0 이상)이라는 이름의 역할 내 캐시 패키지를 설치합니다.

    Caching 미리 보기 패키지(NuGet 1.2)의 스크린 샷

    Caching 미리 보기 패키지(NuGet 2.0)의 스크린 샷

이 패키지는 해당 어셈블리 참조를 추가할 뿐만 아니라 대상 프로젝트의 구성 파일(app.config 또는 web.config)도 수정합니다. 다음과 유사한 상용구 dataCacheClient 섹션을 추가합니다.

<dataCacheClients>
  <dataCacheClient name="default">
    <autoDiscover isEnabled="true" identifier="[cache cluster role name]" />
    <!--<localCache isEnabled="true" sync="TimeoutBased" objectCount="100000" ttlValue="300" />-->
  </dataCacheClient>
</dataCacheClients>

마지막 단계는 "[cache cluster role name]"에서 역할 내 캐시가 사용하도록 설정된 역할의 실제 이름으로 identifier 특성을 변경하는 것입니다. 같은 위치에 배치된 토폴로지에서는 "WebRole1"과 같이 동일한 역할의 이름을 사용할 수 있습니다. 전용 토폴로지에서는 이 이름이 "CacheWorkerRole1" 등의 다른 역할일 수 있습니다. 이러한 두 토폴로지의 예제는 Azure 역할 내 캐시 샘플를 참조하세요.

note참고
NuGet 패키지를 제거해도 사용자 지정된 dataCacheClients 섹션은 제거되지 않으므로 수동으로 제거해야 합니다.

NuGet 패키지는 다음 어셈블리에 대한 참조를 추가합니다.

  • Microsoft.ApplicationServer.Caching.AzureClientHelper

  • Microsoft.ApplicationServer.Caching.AzureCommon

  • Microsoft.ApplicationServer.Caching.Client

  • Microsoft.ApplicationServer.Caching.Core

  • Microsoft.Web.DistributedCache

  • Microsoft.WindowsFabric.Common

  • Microsoft.WindowsFabric.Data.Common

note참고
NuGet 패키지를 사용하지 않고 이러한 어셈블리를 수동으로 참조할 수 있습니다. 기본적으로 이러한 어셈블리는 C:\Program Files\Microsoft SDKs\Azure\.NET SDK\<current version>\ref\Caching에 설치됩니다.

참고 항목

표시: