Preparación del entorno de desarrollo de clientes de caché (Almacenamiento en caché de Windows Server AppFabric)

Artículo
12/05/2011

En este tema se describe cómo preparar el proyecto de Visual Studio de modo que pueda comenzar a desarrollar aplicaciones habilitadas para caché. En los siguientes procedimientos se supone que ya instaló Windows Server AppFabric y configuró las características de caché de AppFabric en uno o varios servidores de caché o en la estación de trabajo de desarrollo. Para obtener más información, vea Guía de instalación de Windows Server AppFabric (https://go.microsoft.com/fwlink/?LinkId=169172) (puede estar en inglés).

Además de instalar las características de caché de AppFabric, debe realizar los siguientes pasos para que el cliente de caché pueda obtener acceso a la memoria caché:

En Windows PowerShell, use Use-CacheCluster para establecer el contexto al clúster de caché de destino.
Cree las memorias caché con nombre necesarias mediante el comando New-Cache.
Conceda acceso a la cuenta de Windows del cliente de caché mediante el comando Grant-CacheAllowedClientAccount.
Inicie el clúster de caché mediante el comando Start-CacheCluster.

Para obtener más información sobre Windows PowerShell y los comandos que se muestran aquí, vea Uso de Windows PowerShell para administrar características de almacenamiento en caché de Windows Server AppFabric.

Preparación del equipo de desarrollo

Para desarrollar una aplicación que use las características de caché de AppFabric, el único requisito de instalación es tener instalada la característica Cliente de caché de AppFabric. Se puede desarrollar un host de caché que tenga instaladas otras características de caché de AppFabric, pero la característica Cliente de caché es el único requisito en la estación de trabajo de desarrollo.

Preparación del proyecto de Visual Studio

Los ensamblados necesarios para desarrollar aplicaciones habilitadas para caché se instalan en la memoria caché de ensamblado global (GAC). Para desarrollar una aplicación de Visual Studio .NET que use estos ensamblados, debe hacer referencia a ellos desde el proyecto.

Procedimiento para destinar la versión correcta de .NET Framework

Abra el proyecto de Visual Studio .NET.
En el Explorador de soluciones, haga clic con el botón secundario en el nombre del proyecto y seleccione Propiedades.
Seleccione la pestaña Aplicación del cuadro de diálogo Propiedades del proyecto.

Verifique que la versión del marco de destino sea .NET Framework 2.0 o superior.

Importante
No use el perfil de cliente para la versión del marco de destino. En Visual Studio 2008, desactive la casilla de verificación Subconjunto de .Net Framework solo de cliente. En Visual Studio 2010, seleccione versiones de .NET Framework que no especifiquen "Client Profile".

Procedimiento para agregar referencias a los ensamblados de caché de AppFabric

Abra el proyecto de Visual Studio .NET.
En el Explorador de soluciones, haga clic con el botón secundario en el nombre del proyecto y seleccione Agregar referencia.
Seleccione la pestaña Examinar del cuadro de diálogo Agregar referencia.
Vaya al directorio .\Windows\System32\AppFabric.

Nota

En sistemas operativos de 64 bits, el directorio de AppFabric no estará directamente visible. Para solucionar este problema, reemplace el nombre del directorio System32 por el nombre SysNative. De este modo, se navegará al directorio C:\Windows\SysNative\AppFabric en este paso.
Agregue una referencia a los dos ensamblados siguientes: Microsoft.ApplicationServer.Caching.Client.dll y Microsoft.ApplicationServer.Caching.Core.dll.
De manera opcional, agregue la declaración de uso (importaciones en Visual Basic) a la parte superior de los archivos de código para hacer referencia al espacio de nombres de Microsoft.ApplicationServer.Caching.

Procedimiento para configurar el cliente de caché

Determine la configuración de cliente adecuada para la aplicación cliente. Para obtener más información sobre el cliente de caché, vea Clientes de caché y caché local (Almacenamiento en caché de Windows Server AppFabric).
Configure el cliente de caché mediante programación o mediante un archivo de configuración de la aplicación. Para ver ejemplos acerca de cómo hacerlo, vea Introducción al cliente de caché de Windows Server AppFabric y Introducción al cliente de caché de Windows Server AppFabric (XML).

Ejemplo

A continuación se muestra un ejemplo de un cliente de caché configurado mediante un archivo de configuración de la aplicación. En este ejemplo, la memoria caché local está deshabilitada y se muestran dos hosts de caché: CacheServer1 y CacheServer2. Para obtener más información, vea Introducción al cliente de caché de Windows Server AppFabric (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"/>
         <host
            name="CacheServer2"
            cachePort="22233"/>
      </hosts>
   </dataCacheClient>
</configuration>

A continuación se muestra un ejemplo de cómo configurar un cliente mediante programación. En este ejemplo, la memoria caché local está deshabilitada, se muestra un solo servidor de caché (CacheServer2) y se crea un cliente de caché para una memoria caché denominada NamedCache1. Para obtener más información, vea Introducción al cliente de caché de Windows Server AppFabric.

' Declare array for cache host(s).
Dim servers(0) As DataCacheServerEndpoint
servers(0) = New DataCacheServerEndpoint("CacheServer2", 22233)

' Setup the DataCacheFactory configuration.
Dim factoryConfig As DataCacheFactoryConfiguration
factoryConfig = New DataCacheFactoryConfiguration
factoryConfig.Servers = servers

' Create a configured DataCacheFactory object.
Dim mycacheFactory As DataCacheFactory
mycacheFactory = New DataCacheFactory(factoryConfig)

' Get a cache client for the cache "NamedCache1".
Dim myDefaultCache As DataCache
myDefaultCache = mycacheFactory.GetCache("NamedCache1")

// Declare array for cache host(s).
DataCacheServerEndpoint[] servers = new DataCacheServerEndpoint[1];
servers[0] = new DataCacheServerEndpoint("CacheServer2", 22233);

// Setup the DataCacheFactory configuration.
DataCacheFactoryConfiguration factoryConfig = new DataCacheFactoryConfiguration();
factoryConfig.Servers = servers;

// Create a configured DataCacheFactory object.
DataCacheFactory mycacheFactory = new DataCacheFactory(factoryConfig);

// Get a cache client for the cache "NamedCache1".
DataCache myDefaultCache = mycacheFactory.GetCache("NamedCache1");

Vea también

Conceptos

Otros recursos

Configuración del cliente caché mediante XML

2011-12-05

Compartir vía