VENTAS: 1-800-867-1389

Procedimiento: Preparación de Visual Studio para usar Caché en rol (Caché de Azure)

Actualizado: julio de 2010

noteNota
Si quiere que le guiemos a la hora de elegir la oferta de Caché de Azure que mejor se adapta a su aplicación, consulte ¿Cuál es la oferta de Caché de Azure más adecuada para mí?.

En este proyecto se explica cómo preparar un proyecto de Visual Studio para que use Caché de Microsoft Azure. Esto incluye las siguientes tareas:

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

  • Hacer referencia a los ensamblados de almacenar en memoria caché.

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

WarningAdvertencia
No debe instalar Microsoft AppFabric 1.1 para Windows Server y Caché de Microsoft Azure en el mismo equipo. Esto incluye tanto el producto como el SDK. Pueden tomarse erróneamente como referencia 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.

  1. Abra su 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).

ImportantImportante
No use el perfil de cliente para la versión de marco de destino. En Visual Studio, seleccione las versiones de .NET Framework que no especifican “Client Profile”.

Para agregar referencias de ensamblado, debe tener instalado el SDK de en el equipo. Para obtener instrucciones, vea 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 para usar Caché en rol hospedada en un rol de 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é en rol llamado Microsoft.WindowsAzure.Caching (NuGet 1.2) o Azure Caching (NuGet 2.0 o superior).

    Captura de pantalla del paquete de vista previa de Caching (NuGet 1,2)

    Captura de pantalla del paquete de vista previa de Caching (NuGet 2,0)

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 es cambiar el atributo identifier de "[cache cluster role name]" al nombre real del rol que tiene habilitada Caché en rol. 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 muestras de ambas topologías, vea Ejemplos de Caché en rol (Caché de Azure).

noteNota
La desinstalación del paquete NuGet no quita la sección dataCacheClients si 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

noteNota
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\Caching.

Vea también

¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios
Mostrar:
© 2014 Microsoft