Začínáme s klientem mezipaměti technologie Windows Server AppFabric (XML)

Technologie Windows Server AppFabric nabízí možnost konfigurovat klienta mezipaměti programově nebo pomocí konfiguračního souboru aplikace. Postupy uvedené v tomto tématu popisují způsob, jak nakonfigurovat klienta mezipaměti pro aplikaci pomocí konfiguračního souboru XML aplikace. Informace o tom, jak to provést programově, naleznete v tématu Začínáme s klientem mezipaměti technologie Windows Server AppFabric.

Další informace o nastavení konfigurace aplikace naleznete v tématu Nastavení konfigurace aplikace (ukládání do mezipaměti technologie Windows Server AppFabric).

V těchto postupech se předpokládá, že jste již připravili své vývojové prostředí, nastavili odkazy na sestavení mezipaměti technologie AppFabric atd. Další informace naleznete v tématu Příprava vývojového prostředí pro vývoj klienta mezipaměti (ukládání do mezipaměti technologie Windows Server AppFabric).

Konfigurace klienta mezipaměti pomocí konfiguračního souboru aplikace

1. V aplikaci Visual Studio vyberte v nabídce Projekt příkaz Přidat novou položku.

2. Vyberte možnost Konfigurační soubor aplikace, jako název souboru zadejte App.config a klikněte na tlačítko Přidat.

3. Vložte příklad XML v souboru App.config do následujícího oddílu uvnitř značek <configuration>. Je možné, že aplikace používá konfigurační soubor aplikace k jiným účelům, avšak ujistěte se, že element configSections je nadále prvním elementem pod značkou configuration.

4. Aktualizujte nebo přidejte elementy host pro hostitele mezipaměti podle vašeho prostředí. U každého z nich:

   • Pomocí atributu name zadejte název počítače hostitele mezipaměti.

   • Pomocí atributu cachePort zadejte pro hostitele číslo portu mezipaměti.

5. Vytvořte v kódu pomocí výchozího konstruktoru objekt DataCacheFactory. Pokud nejsou parametry konfigurace předány do objektu DataCacheFactory, použije aplikace nastavení konfigurace v souboru App.config.

6. Chcete-li začít používat klienta mezipaměti, vytvořte pomocí metody GetCache objekt DataCache.

Příklad

Tento příklad konfiguračního souboru aplikace je nakonfigurován tak, aby odkazoval na dva servery: CacheServer1 a CacheServer2. Nahraďte názvy serverů v tomto příkladu názvy serverů mezipaměti. Přidejte nebo odeberte značky hostitele podle potřeby tak, aby to vyhovovalo vašemu prostředí.

V ideálním případě zadejte hostitele mezipaměti, kteří byli označeni jako hlavní hostitelé. Hlavní hostitelé jsou obvykle servery mezipaměti, které jsou v clusteru nainstalovány jako první. Další informace o hlavních hostitelích naleznete v tématu Obrázek fyzické architektury mezipaměti technologie Windows Server AppFabric.

Chcete-li určit, kteří hostitelé jsou hlavní, můžete použít nástroj pro správu prostředí Windows PowerShell. Další informace o prostředí Windows PowerShell naleznete v tématu Správa funkcí technologie Windows Server AppFabric pro ukládání do mezipaměti pomocí prostředí Windows PowerShell.

Poznámka

Jazyk Visual Basic může nejprve automaticky přidat elementy do vašeho konfiguračního souboru aplikace. Tyto další elementy nejsou požadovány funkcemi mezipaměti technologie AppFabric a pokud je jinak pro svou aplikaci nepotřebujete, mohou být odstraněny.

<?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>

Po zadání nastavení konfigurace klienta mezipaměti do konfiguračního souboru aplikace začněte programovat aplikaci využívající mezipaměť. Tento příklad vytvoří pomocí výchozího konstruktoru objekt DataCacheFactory s názvem CacheFactory1. Nastavení konfigurace klienta mezipaměti není předáno do prvního parametru konstruktoru DataCacheFactory, takže klient mezipaměti bude nakonfigurován podle nastavení zadaného v konfiguračním souboru aplikace.

Poznámka

Z důvodů výkonu doporučujeme minimalizovat počet objektů DataCacheFactory vytvářených v aplikaci využívající mezipaměť. Objekt DataCacheFactory uložte v proměnné, která je dostupná všem částem aplikace používajícím klienty mezipaměti.

Dále je pomocí metody GetCache vytvořen objekt DataCache s názvem myCache1. Potom je volána metoda Add, která objekt přidá do mezipaměti.

' 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");

Další odkazy

Koncepty

Začínáme s klientem mezipaměti technologie Windows Server AppFabric (XML)
Povolení místní mezipaměti technologie Windows Server AppFabric (XML)
Konfigurace zprostředkovatele stavu relace rozhraní ASP.NET (ukládání do mezipaměti technologie Windows Server AppFabric)
Klienti mezipaměti a místní mezipaměť (ukládání do mezipaměti technologie Windows Server AppFabric)
Používání metod konfigurace (ukládání do mezipaměti technologie Windows Server AppFabric)
Koncepce ukládání do mezipaměti technologie Windows Server AppFabric
Vývoj klienta mezipaměti (ukládání do mezipaměti technologie Windows Server AppFabric)

  2011-12-05