Önbellek İstemcisi Geliştirme Ortamını Hazırlama (Windows Server AppFabric Önbelleğe Alma)

Makale
12/05/2011

Bu konuda, önbelleği kullanan uygulamalar geliştirmeye başlayabilecek şekilde Visual Studio projenizi nasıl hazırlayacağınız açıklanmaktadır. Aşağıdaki yordamlarda Windows Server AppFabric'i yüklemiş olduğunuz ve bir ya da daha fazla önbellek sunucusunda veya geliştirme iş istasyonunuzda AppFabric önbelleğe alma özelliklerini yapılandırdığınız varsayılmaktadır. Daha fazla bilgi için bkz. Windows Server AppFabric Yükleme Kılavuzu (https://go.microsoft.com/fwlink/?LinkId=169172).

AppFabric önbelleğe alma özelliklerini yüklemenin yanı sıra, önbellek istemcisi önbelleğe erişmeden önce aşağıdaki adımları da gerçekleştirmelisiniz:

Windows PowerShell'de, hedef önbellek kümesine bağlamı ayarlamak üzere Use-CacheCluster komutunu kullanın.
New-Cache komutunu kullanarak tüm gerekli adlandırılmış önbellekleri oluşturun.
Grant-CacheAllowedClientAccount komutunu kullanarak önbellek istemcisinin Windows hesabına erişim izni atayın.
Start-CacheCluster komutunu kullanarak önbellek kümesini başlatın.

Windows PowerShell'i kullanma ve burada listelenen komutlar hakkında daha fazla bilgi için bkz. Windows Server AppFabric Önbelleğe Alma Özelliklerini Yönetmek için Windows PowerShell Kullanma.

Geliştirme Bilgisayarını Hazırlama

AppFabric önbelleğe alma özelliklerini kullanan bir uygulama geliştirmek için tek kurulum gereksinimi AppFabric'in Önbellek İstemcisi özelliğinin yüklü olmasıdır. Diğer AppFabric önbelleğe alma özelliklerinin yüklü olduğu bir önbellek konağında da geliştirilebilir, ancak geliştirme iş istasyonu için tek gereksinim Önbellek İstemcisi özelliğidir.

Visual Studio Projesini Hazırlama

Önbelleği kullanan uygulamalar geliştirmek için gereken derlemeler, genel derleme önbelleğine (GAC) kaydedilir. Bu derlemeleri kullanan bir Visual Studio .NET uygulaması geliştirmek için bunlara projeniz içinden başvurmalısınız.

Doğru .NET Framework sürümünü hedeflemek için

Visual Studio .NET projenizi açın.
Çözüm Gezgini'nde, proje adını sağ tıklatın ve ardından Özellikler'i seçin.
Proje Özellikleri iletişim kutusunun Uygulama sekmesini seçin.
Hedef Framework sürümünün .NET Framework 2.0 veya sonraki bir sürümü olduğunu doğrulayın.

Önemli

Hedef Framework sürümü için istemci profili kullanmayın. Visual Studio 2008'de Yalnızca istemci Framework alt kümesi onay kutusundaki işareti kaldırın. Visual Studio 2010'da "İstemci Profili" belirtmeyen .NET Framework sürümleri seçin.

AppFabric önbelleğe alma derlemelerine başvuru eklemek için

Visual Studio .NET projenizi açın.
Çözüm Gezgini'nde, proje adını sağ tıklatın ve ardından Başvuru Ekle'yi seçin.
Başvuru Ekle iletişim kutusunun Gözat sekmesini seçin.
.\Windows\System32\AppFabric dizinine gidin.

Not

64-bit işletim sistemlerinde, AppFabric dizini doğrudan görünür değildir. Bu soruna geçici bir çözüm bulmak için System32 dizin adını SysNative olarak değiştirin. Dolayısıyla, bu adımda C:\Windows\SysNative\AppFabric dizinine gitmeniz gerekecektir.
Şu iki derlemeye başvuru ekleyin: Microsoft.ApplicationServer.Caching.Client.dll ve Microsoft.ApplicationServer.Caching.Core.dll.
İsteğe bağlı olarak, Microsoft.ApplicationServer.Caching ad alanına başvurmak üzere kod dosyalarının başına "using" deyimini (Visual Basic'teki Almalar) ekleyin.

Önbellek istemcisini yapılandırmak için

İstemci uygulaması için uygun istemci ayarlarını belirleyin. Önbellek istemcisi türleri hakkında daha fazla bilgi için bkz. Önbellek İstemcileri ve Yerel Önbellek (Windows Server AppFabric Önbelleğe Alma).
Önbellek istemcinizi program yoluyla veya uygulama yapılandırması dosyası kullanarak yapılandırın. Bunun nasıl yapılacağı ile ilgili örnekler için bkz. Windows Server AppFabric Önbellek İstemcisini Kullanmaya Başlama ve Windows Server AppFabric Önbellek İstemcisini Kullanmaya Başlama (XML).

Örnek

Aşağıdaki örnek, uygulama yapılandırma dosyası kullanılarak yapılandırılmış bir önbellek istemcisidir. Bu örnekte yerel önbellek devre dışı bırakılmıştır ve iki önbellek konağı listelenmektedir: CacheServer1 ve CacheServer2. Daha fazla bilgi için bkz. Windows Server AppFabric Önbellek İstemcisini Kullanmaya Başlama (XML).

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
   <!--configSections must be the FIRST element -->
   <configSections>
      <!-- required to read the <dataCacheClient> element -->
      <section name="dataCacheClient"
         type="Microsoft.ApplicationServer.Caching.DataCacheClientSection,
            Microsoft.ApplicationServer.Caching.Core, Version=1.0.0.0, 
            Culture=neutral, PublicKeyToken=31bf3856ad364e35"
         allowLocation="true"
         allowDefinition="Everywhere"/>
   </configSections>

   <dataCacheClient>
      <!-- (optional) specify local cache
      <localCache
         isEnabled="true"
         sync="TimeoutBased"
         objectCount="100000"
         ttlValue="300" /> -->

      <!--(optional) specify cache notifications poll interval
      <clientNotification pollInterval="300" /> -->

      <hosts>
         <host
            name="CacheServer1"
            cachePort="22233"/>
         <host
            name="CacheServer2"
            cachePort="22233"/>
      </hosts>
   </dataCacheClient>
</configuration>

Aşağıdaki örnek, bir istemciyi program yoluyla yapılandırma ile ilgilidir. Bu örnekte yerel önbellek devre dışı bırakılmıştır, yalnızca bir önbellek sunucusu (CacheServer2) listelenir ve NamedCache1 adlı önbellek için bir önbellek istemcisi oluşturulur. Daha fazla bilgi için bkz. Windows Server AppFabric Önbellek İstemcisini Kullanmaya Başlama.

' Declare array for cache host(s).
Dim servers(0) As DataCacheServerEndpoint
servers(0) = New DataCacheServerEndpoint("CacheServer2", 22233)

' Setup the DataCacheFactory configuration.
Dim factoryConfig As DataCacheFactoryConfiguration
factoryConfig = New DataCacheFactoryConfiguration
factoryConfig.Servers = servers

' Create a configured DataCacheFactory object.
Dim mycacheFactory As DataCacheFactory
mycacheFactory = New DataCacheFactory(factoryConfig)

' Get a cache client for the cache "NamedCache1".
Dim myDefaultCache As DataCache
myDefaultCache = mycacheFactory.GetCache("NamedCache1")

// Declare array for cache host(s).
DataCacheServerEndpoint[] servers = new DataCacheServerEndpoint[1];
servers[0] = new DataCacheServerEndpoint("CacheServer2", 22233);

// Setup the DataCacheFactory configuration.
DataCacheFactoryConfiguration factoryConfig = new DataCacheFactoryConfiguration();
factoryConfig.Servers = servers;

// Create a configured DataCacheFactory object.
DataCacheFactory mycacheFactory = new DataCacheFactory(factoryConfig);

// Get a cache client for the cache "NamedCache1".
DataCache myDefaultCache = mycacheFactory.GetCache("NamedCache1");

Ayrıca bkz.

Kavramlar

Diğer Kaynaklar

Önbellek İstemcisini XML ile Yapılandırma

2011-12-05

Aracılığıyla paylaş