Exportar (0) Imprimir
Expandir todo

Procedimiento: Preparación de Visual Studio para el uso de In-Role Cache (Azure Cache)

Actualizado: febrero de 2014

En este tema se describe la preparación de un proyecto Visual Studio para que use Caché de Microsoft Azure. Esto incluye las tareas siguientes:

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

  • Haga referencia a los ensamblados de Caché.

Después de estas tareas, puede configurar el cache client en la sección dataCacheClient de los archivos web.config o app.config. Esto le permitirá utilizar los métodos Caché del 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 ensamblados Microsoft AppFabric 1.1 para Windows Server en la Caché de ensamblado global. Esto podría conllevar un comportamiento incorrecto o inesperado.

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

  1. Abra el proyecto 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 proyectos de Visual C#, siga estos pasos:

    1. Seleccione la pestaña Aplicación del cuadro de diálogo Propiedades del proyecto.

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

  4. Para proyectos de Visual Basic, siga estos pasos:

    1. Seleccione la sección Compilar de la página Propiedades del proyecto.

    2. Al final de la página Compilar, haga clic en el botón Opciones de compilación avanzadas.

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

ImportantImportante
No use el perfil de cliente para la versión del marco de destino. En Visual Studio, seleccione las versiones de .NET Framework en las que no se especifique "Client Profile".

Configuración de un proyecto para el caching en roles

Para agregar referencias de ensamblado, el SDK de Microsoft Azure debe estar instalado en el equipo. Si desea obtener instrucciones, vea Descarga del SDK de Azure.

En los pasos siguientes se utiliza un paquete NuGet para agregar las referencias de ensamblado y los cambios de configuración necesarios. Estos pasos son específicos para usar Caché en rol, que se encuentra alojado en un rol de Microsoft 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 paquetes de biblioteca (NuGet 1.2) o Administrar paquetes NuGet (NuGet 2.0 o posterior).

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

  3. Busque WindowsAzure.Caching.

  4. Instale el paquete de Caché en rol con el nombre Microsoft.WindowsAzure.Caching (NuGet 1.2) o Azure Caching (NuGet 2.0 o posterior).

    Captura de pantalla de paquete de vista previa de almacenamiento en caché (NuGet 1.2)

    Captura de pantalla de paquete de vista previa de almacenamiento en caché (NuGet 2,0)

Además de agregar las referencias de ensamblado adecuadas, este paquete también modifica el archivo de configuración (app.config o web.config) para el proyecto de destino. También agrega una sección dataCacheClient reutilizable similar a lo que se indica a continuación.

<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 identifier de "[cache cluster role name]" al nombre real del rol que tiene Caché en rol habilitado. En una topología colocalizada, podría ser el mismo rol como, por ejemplo, "WebRole1". En una topología dedicada, podría ser un rol diferente, como "CacheWorkerRole1". Para obtener ejemplos de ambas topologías, consulte Ejemplos de In-Role Cache (Azure Cache).

noteNota
Al desinstalar el paquete NuGet, la sección dataCacheClients no se suprime si se ha personalizado. Debe suprimirla 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 manera predeterminada, se instalan en C:\Archivos de programa\Microsoft SDKs\Azure\.NET SDK\<versión actual>\ref\Caching.

Vea también

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft