Introdução a um cliente de cache (XML) do Windows Server AppFabric

O Windows Server AppFabric oferece a opção para configurar o cliente de cache programaticamente ou com um arquivo de configuração do aplicativo. Os procedimentos neste tópico descrevem como configurar um cliente de cache para seu aplicativo usando um arquivo de configuração do aplicativo baseado em XML. Para obter informações sobre como fazer isso de forma programática, consulte Introdução a um cliente de cache do Windows Server AppFabric.

Para obter mais informações sobre as definições de configuração de aplicativo, consulte Definições de configuração do aplicativo (Cache do Windows Server AppFabric).

Esses procedimentos presumem que você já preparou seu ambiente de desenvolvimento, definiu referências para os assemblies de cache do AppFabric e assim por diante. Para obter mais informações, consulte Preparando o ambiente de desenvolvimento do cliente de cache (Cache do Windows Server AppFabric).

Para configurar um cliente de cache usando um arquivo de configuração do aplicativo

1. No menu Projeto no Visual Studio, selecione Adicionar novo item.

2. Selecione Arquivo de configuração do aplicativo, nomeie o arquivo App.config e clique em Adicionar.

3. Cole o exemplo XML na seção a seguir dentro das marcas <configuration> do seu arquivo App.config. Seu aplicativo pode usar o arquivo de configuração do aplicativo para outros fins, mas verifique se o elemento configSections continua sendo o primeiro elemento na marca configuration.

4. Atualize ou adicione elementos host para os hosts de cache, conforme apropriado para seu ambiente. Para cada um:

   • Use o atributo name para especificar o nome do computador do host de cache.

   • Use o atributo cachePort para especificar o número da porta do cache do host.

5. No seu código, crie um objeto DataCacheFactory usando a construção padrão. Ao não passar os parâmetros de configuração para o objeto DataCacheFactory, seu aplicativo usará as definições de configuração no arquivo App.config.

6. Para começar a usar o cliente de cache, use o método GetCache para criar um objeto DataCache.

Exemplo

Esse arquivo de configuração do aplicativo de exemplo está configurado para apontar para dois servidores, CacheServer1 e CacheServer2. Substitua os nomes de servidor neste exemplo pelos nomes dos seus servidores de cache. Adicione ou remova marcas de host conforme necessário para que fiquem adequadas ao seu ambiente.

De forma ideal, especifique os hosts de cache que foram designados como hosts principais. Os hosts principais geralmente são os primeiros servidores de cache instalados no cluster. Para obter mais informações sobre hosts principais, consulte Diagrama de arquitetura física de cache do Windows Server AppFabric.

Você pode determinar quais são os hosts principais usando a ferramenta de administração do Windows PowerShell. Para obter mais informações sobre o Windows PowerShell, consulte Usando o Windows PowerShell para gerenciar os recursos de cache do Windows Server AppFabric.

Dica

O Visual Basic pode primeiro adicionar automaticamente elementos ao seu arquivo de configuração do aplicativo. Esses elementos adicionais não são necessários para os recursos de cache do AppFabric e poderão ser excluídos se você não precisar deles para seu aplicativo.

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

Depois de especificar as definições de configuração do cliente de cache no arquivo de configuração do aplicativo, comece a programar seu aplicativo habilitado para cache. Este exemplo cria um objeto DataCacheFactory chamado CacheFactory1 usando o construtor padrão. Como as definições de configuração do cliente de cache não são passadas para o primeiro parâmetro do construtor DataCacheFactory, o cliente de cache será configurado com base nas configurações especificadas no arquivo de configuração do aplicativo.

Dica

Por motivos de desempenho, recomendamos que você minimize o número de objetos DataCacheFactory criados em um aplicativo habilitado para cache. Armazene o objeto DataCacheFactory em uma variável disponível para todas as partes do aplicativo que usam o clientes de cache.

Em seguida, o método GetCache é usado para criar um objeto DataCache chamado myCache1. Assim, o método Add é chamado para adicionar um objeto ao cache.

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

Consulte também

Conceitos

Introdução a um cliente de cache (XML) do Windows Server AppFabric
Habilitar cache local (XML) do Windows Server AppFabric
Configurando um provedor de estado da sessão ASP.NET (Cache do Windows Server AppFabric)
Clientes de cache e cache local (Cache do Windows Server AppFabric)
Usando métodos de configuração (Cache do Windows Server AppFabric)
Conceitos de cache do Windows Server AppFabric
Desenvolvendo um cliente de cache (cache do Windows Server AppFabric)

  2011-12-05