Preparación de Visual Studio para usar Azure In-Role Cache

Importante

Microsoft recomienda todos los nuevos desarrollos que usen Azure Redis Cache. Para obtener documentación actual e instrucciones sobre cómo elegir una oferta de Azure Cache, consulte ¿Qué oferta de Azure Cache es adecuada para mí?

En este tema se explica cómo preparar un proyecto de Visual Studio para usar Microsoft Azure Cache. Esto incluye las siguientes tareas:

• Comprobar que se establezca como destino la versión correcta de .NET Framework.

• Haga referencia a los ensamblados de almacenamiento en caché.

Después de estas tareas, puede configurar el cliente de caché en la sección dataCacheClient de la aplicación o web.config archivos. Esto le permite usar los métodos de almacenamiento en caché en el espacio de nombres Microsoft.ApplicationServer.Caching .

Advertencia

No debe instalar Microsoft AppFabric 1.1 para Windows Server y Microsoft Azure Cache en la misma máquina. Esto incluye tanto el producto como el SDK. Es posible hacer referencia erróneamente a algunos de los ensamblados de Microsoft AppFabric 1.1 para Windows Server en la caché global de ensamblados. Esto podría provocar un comportamiento incorrecto o inesperado.

Para establecer como destino la versión correcta de .NET Framework

1. Abra el proyecto de Visual Studio.

2. En el Explorador de soluciones, haga clic con el botón secundario en el nombre del proyecto y seleccione Propiedades.

3. Para un proyecto de Visual C#, siga los pasos que se indican a continuación:

   1. Seleccione la pestaña Aplicación del cuadro Propiedades del proyecto.

   2. Compruebe que la versión de marco de destino sea .NET Framework 2.0 o superior (perfil de no cliente).

4. Para un proyecto de Visual Basic, siga los pasos que se indican a continuación:

   1. Seleccione la pestaña Compilar del cuadro Propiedades del proyecto.

   2. En la parte inferior de la página Compilar, haga clic en Opciones de compilación avanzadas.

   3. Compruebe que la versión de marco de destino sea .NET Framework 2.0 o superior (perfil de no cliente).

Importante

No use el perfil de cliente para la versión de marco de destino. En Visual Studio, seleccione versiones de .NET Framework que no especifiquen "Perfil de cliente".

Configurar un proyecto para el almacenamiento en caché en roles

Para agregar las referencias de ensamblado, debe tener instalado el SDK de Azure en la máquina. Para obtener instrucciones, consulte Descarga del SDK de Azure.

Los pasos siguientes usan un paquete de NuGet para agregar los cambios de configuración y las referencias de ensamblado necesarios. Estos pasos son específicos del uso de In-Role Caché que se hospeda en un rol de Azure en la misma implementación.

1. En el Explorador de soluciones, haga clic con el botón secundario en el nombre del proyecto y seleccione Agregar referencia de paquete de biblioteca (NuGet 1.2) o Administrar paquetes de NuGet (NuGet 2.0 o superior).

2. En el panel izquierdo, seleccione la categoría En línea.

3. Busque WindowsAzure.Caching.

4. Instale el paquete de caché de In-Role denominado Microsoft.WindowsAzure.Caching (NuGet 1.2) o El almacenamiento en caché de Azure (NuGet 2.0 o posterior).

   

   

Además de agregar las referencias de ensamblado apropiadas, este paquete también modifica el archivo de configuración (app.config o web.config) del proyecto de destino. Agrega una sección dataCacheClient reutilizable similar a la siguiente.

<dataCacheClients>
  <dataCacheClient name="default">
    <autoDiscover isEnabled="true" identifier="[cache cluster role name]" />
    <!--<localCache isEnabled="true" sync="TimeoutBased" objectCount="100000" ttlValue="300" />-->
  </dataCacheClient>
</dataCacheClients>

El último paso consiste en cambiar el atributo de identificador de "[cache cluster role name]" al nombre real del rol que tiene habilitada la caché In-Role. En una topología colocalizada, podría ser el mismo rol, como "WebRole1". En una topología dedicada, podría ser otro rol, como "CacheWorkerRole1". Para obtener ejemplos de ambas topologías, consulte Ejemplos de caché de Azure In-Role.

Nota

Al desinstalar el paquete de NuGet no se quita la sección dataCacheClients si esa sección se ha personalizado. Se debe quitar manualmente.

El paquete NuGet agrega referencias a los ensamblados siguientes:

• Microsoft.ApplicationServer.Caching.AzureClientHelper

• Microsoft.ApplicationServer.Caching.AzureCommon

• Microsoft.ApplicationServer.Caching.Client

• Microsoft.ApplicationServer.Caching.Core

• Microsoft.Web.DistributedCache

• Microsoft.WindowsFabric.Common

• Microsoft.WindowsFabric.Data.Common

Nota

Es posible hacer referencia manualmente a estos ensamblados sin el paquete NuGet. De forma predeterminada, se instalan en C:\Archivos de programa\Microsoft SDKs\Azure\.NET SDK<versión> actual\ref\Almacenamiento en caché.

Consulte también

Conceptos

Desarrollar para la Caché en rol de Azure
Proveedores de caché de ASP.NET 4 para Caché en rol de Azure