Windows Server AppFabric Önbellek İstemcisini Kullanmaya Başlama (XML)

Windows Server AppFabric, önbellek istemcisini program yoluyla veya uygulama yapılandırma dosyası aracılığıyla yapılandırma seçeneği sunar. Bu konuda yer alan yordamlar, uygulamanız için önbellek istemcisini XML tabanlı bir uygulama yapılandırma dosyasını kullanarak nasıl yapılandıracağınızı açıklamaktadır. Bunu program yoluyla yapma hakkında bilgi için bkz. Windows Server AppFabric Önbellek İstemcisini Kullanmaya Başlama.

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 yordamlar, geliştirme ortamınızı zaten hazırladığınızı, AppFabric önbelleğe alma derlemelerine yönelik başvuruları ayarladığınızı ve benzerini varsaymaktadır. Daha fazla bilgi için bkz. Önbellek İstemcisi Geliştirme Ortamını Hazırlama (Windows Server AppFabric Önbelleğe Alma).

Uygulama yapılandırma dosyası kullanarak önbellek istemcisi yapılandırmak için

1. Visual Studio'da Proje menüsünde Yeni Öğe Ekle seçeneğini belirleyin.

2. Uygulama Yapılandırma Dosyası seçeneğini belirleyin, dosyaya App.config adını verin ve ardından Ekle'yi tıklatın.

3. XML örneğini aşağıdaki bölüme, App.config dosyanızın <configuration> etiketlerinin içine yapıştırın. Uygulamanız, uygulama yapılandırma dosyasını başka amaçlar için kullanabilir, ancak configSections öğesinin configuration etiketi altında ilk öğe olarak kalmasını sağlayın.

4. Önbellek konaklarınıza ortamınız için uygun host öğeleri ekleyin veya güncelleştirin. Her biri için:

   • Önbellek konağının bilgisayar adını belirlemek için name özniteliğini kullanın.

   • Konağın önbellek bağlantı noktasını belirlemek için cachePort özniteliğini kullanın.

5. Kodunuzda, varsayılan yapıyı kullanarak bir DataCacheFactory nesnesi oluşturun. Yapılandırma parametrelerini DataCacheFactory nesnesine geçirmezseniz, uygulamanız App.config dosyasındaki yapılandırma ayarlarını kullanır.

6. Önbellek istemcisini kullanmaya başlamak için GetCache yöntemini kullanarak bir DataCache nesnesi oluşturun.

Örnek

Bu örnek uygulama yapılandırma dosyası iki sunucuyu gösterecek şekilde yapılandırılmıştır; CacheServer1 ve CacheServer2. Bu örnekteki sunucu adları yerine önbellek sunucularınızın adlarını yazın. Ortamınıza uyması için gereken konak etiketlerini ekleyin veya çıkarın.

İdeal olarak, temel konak olarak belirlenmiş ö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, ilk başta uygulama yapılandırma dosyanıza otomatik olarak öğe ekleyebilir. Bu ek öğeler, AppFabric'in önbelleğe alma özellikleri için gerekli değildir ve uygulamanız için bu öğelere ihtiyacınız yoksa onları silebilirsiniz.

<?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>
      <hosts>
         <host
            name="CacheServer1"
            cachePort="22233"/>
         <host
            name="CacheServer2"
            cachePort="22233"/>
      </hosts>
   </dataCacheClient>
</configuration>

Uygulama yapılandırma dosyasında önbellek istemci yapılandırma ayarlarını belirledikten sonra önbellek kullanan uygulamanızı programlamaya başlayın. Bu örnek, varsayılan oluşturucuyu kullanarak CacheFactory1 adlı bir DataCacheFactory nesnesi oluşturur. Önbellek istemci yapılandırma ayarları, DataCacheFactory oluşturucusunun ilk parametresine geçirilmediğinden önbellek istemcisi, uygulama yapılandırma dosyasında belirtilen ayarları temel alarak yapılandırılır.

Not

Performanstan kaynaklanan nedenlerle, önbelleği kullanan bir uygulamada oluşturulan DataCacheFactory nesnelerinin sayısını en aza indirmeniz önerilir. DataCacheFactory nesnesini, uygulamanın önbellek istemcilerini kullanan tüm bölümleri tarafından kullanılabilen bir değişkende depolayın.

Daha sonra GetCache yöntemi kullanılarak myCache1 adlı bir DataCache nesnesi oluşturulur. Ardından önbelleğe bir nesne eklemek için Add yöntemi çağrılır.

' Use configuration from the application configuration file.
Dim CacheFactory1 As DataCacheFactory = New DataCacheFactory()

' Get cache client for cache "NamedCache1".
Dim myCache1 As DataCache = CacheFactory1.GetCache("NamedCache1")

' Add an object to the cache.
myCache1.Add("helloKey", "hello world")

// Use configuration from the application configuration file.
DataCacheFactory CacheFactory1 = new DataCacheFactory();

// Get cache client for cache "NamedCache1".
DataCache myCache1 = CacheFactory1.GetCache("NamedCache1");

// Add an object to the cache.
myCache1.Add("helloKey", "hello world");

Ayrıca bkz.

Kavramlar

Windows Server AppFabric Önbellek İstemcisini Kullanmaya Başlama (XML)
Windows Server AppFabric Yerel Önbelleğini Etkinleştirme (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