Introduzione a un client della cache (XML)

Microsoft AppFabric 1.1 per Windows Server offre la possibilità di configurare un client della cache a livello di programmazione o mediante un file di configurazione dell'applicazione. In questo argomento vengono descritte le procedure per configurare un client della cache per l'applicazione in uso mediante l'utilizzo di un file di configurazione dell'applicazione basato su XML. Per ulteriori informazioni su come eseguire questa operazione a livello di programmazione, vedere Introduzione a un client della cache.

Per ulteriori informazioni sulle impostazioni di configurazione dell'applicazione, vedere Impostazioni di configurazione dell'applicazione (Memorizzazione nella cache di AppFabric 1.1).

Ai fini di queste procedure, si presuppone che l'ambiente di sviluppo sia già stato preparato, che i riferimenti agli assembly di memorizzazione nella cache di AppFabric siano stati definiti e così via. Per ulteriori informazioni, vedere Preparazione dell'ambiente di sviluppo del client della cache (Memorizzazione nella cache di AppFabric 1.1).

Per configurare un client della cache mediante un file di configurazione dell'applicazione

  1. Scegliere Aggiungi nuovo elemento dal menu Progetto in Visual Studio.

  2. Scegliere File di configurazione dell'applicazione, assegnarvi il nome App.config, quindi fare clic su Aggiungi..

  3. Incollare l'esempio XML nella sezione seguente all'interno dei tag <configuration> del file App.config. L'applicazione può utilizzare il relativo file di configurazione per altri scopi, ma assicurarsi che configSections rimanga il primo elemento sotto il tag configuration.

  4. Aggiornare o aggiungere gli elementi host per gli host della cache in base alle esigenze dell'ambiente in uso. Per ciascun elemento:

    • Utilizzare l'attributo name per specificare il nome del computer dell'host della cache.

    • Utilizzare l'attributo cachePort per specificare il numero della porta cache.

  5. All'interno del codice, creare un oggetto DataCacheFactory mediante il costrutto predefinito. Se non vengono passati i parametri di configurazione all'oggetto DataCacheFactory, l'applicazione utilizzerà le impostazioni di configurazione presenti nel file App.config.

  6. Per iniziare a utilizzare il client della cache, utilizzare il metodo GetCache per creare un metodo DataCache.

Esempio

In questo file di configurazione dell'applicazione di esempio è configurato per puntare a due server, CacheServer1 e CacheServer2. Sostituire i nomi server illustrati in questo esempio con quelli dei propri server della cache. Aggiungere o rimuovere i tag host secondo necessità in base all'ambiente.

Idealmente, specificare gli host della cache designati come host principali. In genere, gli host principali sono i primi server di cache installati nel cluster. Per ulteriori informazioni sugli host principali, vedere Diagramma dell'architettura fisica della memorizzazione nella cache di AppFabric (Memorizzazione nella cache di AppFabric 1.1).

Per determinare quali host siano principali, utilizzare lo strumento di amministrazione di Windows PowerShell. Per ulteriori informazioni su Windows PowerShell, vedere Utilizzo di Windows PowerShell per la gestione delle funzionalità di memorizzazione nella cache di AppFabric 1.1.

Nota

È possibile che inizialmente vengano aggiunti automaticamente elementi al file di configurazione dell'applicazione. Questi elementi aggiuntivi non sono richiesti dalle funzionalità di memorizzazione nella cache di AppFabric e possono essere eliminati se non sono necessari per altre operazioni dell'applicazione.

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

Dopo aver specificato le impostazioni di configurazione del client della cache nel file di configurazione dell'applicazione, iniziare la programmazione dell'applicazione abilitata alla cache. In questo esempio viene creato un oggetto DataCacheFactory denominato CacheFactory1 che utilizza il costruttore predefinito. Poiché le impostazioni di configurazione del client della cache non vengono passate al primo parametro del costruttore DataCacheFactory, il client della cache verrà configurato in base alle impostazioni specificate nel file di configurazione dell'applicazione.

Nota

Per ottenere prestazioni ottimali, è consigliabile ridurre al minimo il numero di oggetti DataCacheFactory creati in un'applicazione abilitata alla cache. Archiviare l'oggetto DataCacheFactory in una variabile che sia disponibile per tutte le parti dell'applicazione che utilizzano i client della cache.

Successivamente, viene utilizzato il metodo GetCache per creare un oggetto DataCache denominato myCache1. Viene, quindi, chiamato il metodo Add per aggiungere un oggetto alla 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");

Vedere anche

Concetti

Abilitare la cache locale (XML)
Client della cache e cache locale (Memorizzazione nella cache di AppFabric 1.1)
Utilizzo dei metodi di configurazione
Concetti di memorizzazione nella cache di AppFabric (Memorizzazione nella cache di AppFabric 1.1)
Sviluppo di un client della cache

Altre risorse

Procedure: Introduzione a un client di routing (XML)
Procedure: Configurare un provider di stato della sessione (XML)

  2012-03-05