Windows Server AppFabric Yerel Önbelleğini Etkinleştirme (XML)

Windows Server AppFabric, önbellek istemcisini program yoluyla veya uygulama yapılandırma dosyasıyla yapılandırma seçeneği sunar. Bu konudaki yordamlarda, XML tabanlı uygulama yapılandırma dosyası kullanıldığında önbellek istemcisindeki yerel önbelleğin nasıl etkinleştirileceği anlatılmaktadır. Bunu program yoluyla yapma hakkında bilgi için bkz. Windows Server AppFabric Yerel Önbelleğini Etkinleştirme.

Uygulama yapılandırma dosyasında, yerel önbellek ayarları dataCacheClient öğesinin alt öğesi olan localCache öğesinde tanımlanır. localCache öğesindeki isEnabled özniteliği yerel önbelleğin etkin olup olmayacağını belirler. Alternatif olarak, devre dışı bırakıldığını belirtmek için localCache öğesi eksik (veya açıklama işareti kaldırılmış) olabilir. Uygulama yapılandırma ayarları hakkında daha fazla bilgi için bkz. Uygulama Yapılandırma Ayarları (Windows Server AppFabric Önbelleğe Alma).

Bu yordamlarda, geliştirme ortamını önceden hazırladığınız ve AppFabric önbellek derlemelerine başvuruları ayarladığınız kabul edilmektedir. Daha fazla bilgi için bkz. Önbellek İstemcisi Geliştirme Ortamını Hazırlama (Windows Server AppFabric Önbelleğe Alma).

Yerel önbelleği uygulama yapılandırma dosyası ile etkinleştirmek için

1. App.config adlı uygulama yapılandırma dosyasını oluşturun ve projenize ekleyin. Daha fazla bilgi için bkz. Windows Server AppFabric Önbellek İstemcisini Kullanmaya Başlama (XML).

2. localCache öğesini dataCacheClient öğesinin alt öğesi olarak ekleyin.

3. Yerel önbelleği etkinleştirmek için localCache öğesinin isEnabled özniteliğini true değerine eşit olarak ayarlayın.

4. localCache öğesinde sync özniteliğini ayarlayın. Yerel önbelleği geçersiz kılmaya yönelik zaman aşımını kullanmak için bu özniteliği TimeoutBased olarak ayarlayın. Yerel önbelleği geçersiz kılmak üzere ek olarak önbellek bildirimlerini kullanmak için NotificationBased seçeneğini kullanın. NotificationsBased seçeneği, adlandırılmış önbellekte önbellek bildirimlerinin etkinleştirilmesini gerektirir. Daha fazla bilgi için bkz. Önbellek Bildirimleri (Windows Server AppFabric Önbelleğe Alma).

5. localCache öğesindeki ttlValue özniteliğini nesnelerin yerel önbellekte kalacağı istenen saniye sayısına eşit olarak ayarlayın. Varsayılan değer 300 saniyedir. Daha fazla bilgi için bkz. Süre Sonu ve Çıkarma (Windows Server AppFabric Önbelleğe Alma).

6. İsteğe bağlı olarak yerel önbelleğe alınan en fazla nesne sayısını belirtmek için localCache öğesinde objectCount özniteliğini ayarlayın. Varsayılan değer 10.000 nesnedir. Bu eşik değeri, önbellek istemcisinin yerel önbelleğe alınmış nesnelerin son kullanılanlarından en az kullanılanlarının yüzde 20'sini çıkarmaya başlamasına neden olur.

7. İsteğe bağlı olarak, önbellek bildirimlerini kullanıyorsanız ve 300 saniyelik varsayılan değerden farklı bir yoklama aralığı belirtmek istiyorsanız, clientNotification öğesini dataCacheClient öğesinin altına ekleyin. Yoklama aralık değerini belirtmek için clientNotification öğesinin pollInterval özniteliğini kullanın. Bu öğe ve öznitelik, yerel önbelleği kullanmak istemeseniz bile önbellek bildirimlerine yönelik yoklama aralığı belirtmek için kullanılabilir.

Örnek

Bu örnekte, yerel önbellek etkinleştirildiğinde yerel önbellek öğesinin nasıl göründüğü gösterilmektedir. Bu öğe dataCacheClient öğesinin içine eklenmelidir.

XML

<!-- local cache enabled -->
<localCache
  isEnabled="true"
  sync="TimeoutBased"
  objectCount="100000"
  ttlValue="300" />

Bu örnek uygulama yapılandırma dosyasında yerel önbellek etkindir ve bir önbellek sunucusunu, CacheServer1'i işaret edecek şekilde yapılandırılmıştır. Bu örneği kullanmak için, bu örnekteki sunucu adını önbellek sunucunuzun adıyla değiştirin. Ortamınıza uyması için gereken konak etiketlerini ekleyin veya çıkarın.

İdealde, temel konak olarak belirlenmiş olan önbellek konaklarını belirtin. Temel konaklar genellikle kümeye ilk yüklenen önbellek sunucularıdır. Temel konaklar hakkında daha fazla bilgi için bkz. Windows Server AppFabric Önbelleğe Alma Fiziksel Mimarisi Diyagramı. Windows PowerShell yönetim aracını kullanarak, hangi konakların temel konak olduklarını belirleyebilirsiniz. Windows PowerShell hakkında daha fazla bilgi için bkz. Windows Server AppFabric Önbelleğe Alma Özelliklerini Yönetmek için Windows PowerShell Kullanma.

Not

Visual Basic başlangıçta uygulamanızın yapılandırma dosyasına otomatik olarak öğe ekleyebilir. Bu ek öğeler AppFabric'in önbelleğe alma özellikleri tarafından istenmez ve uygulamanız için onlara başka bir şekilde ihtiyacınız yoksa silinebilirler.

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"/>
      </hosts>
   </dataCacheClient>
</configuration>

Ayrıca bkz.

Kavramlar

Windows Server AppFabric Önbellek İstemcisini Kullanmaya Başlama (XML)
ASP.NET Oturum Durumu Sağlayıcısı Yapılandırma (Windows Server AppFabric Önbelleğe Alma)
Önbellek İstemcileri ve Yerel Önbellek (Windows Server AppFabric Önbelleğe Alma)
Yapılandırma Yöntemlerini Kullanma (Windows Server AppFabric Önbelleğe Alma)
Windows Server AppFabric Önbelleğe Alma Kavramları
Önbellek İstemcisi Geliştirme (Windows Server AppFabric Önbelleğe Alma)

  2011-12-05