Procedura: Preparare Visual Studio per l'uso della cache di Azure In-Role

Importante

Microsoft consiglia tutti i nuovi sviluppi che usano Cache Redis di Azure. Per la documentazione e le indicazioni correnti sulla scelta di un'offerta di Cache di Azure, vedere Quale offerta di Cache di Azure è adatta per l'utente?

Questo argomento illustra come preparare un progetto di Visual Studio da usare Microsoft Azure Cache. Sono incluse le seguenti attività:

  • Verificare che come destinazione sia specificata la versione corretta di .NET Framework.

  • Fare riferimento agli assembly di memorizzazione nella cache.

Dopo queste attività, è possibile configurare il client della cache nella sezione dataCacheClient dell'applicazione o dei file web.config. Ciò consente di usare i metodi di memorizzazione nella cache nello spazio dei nomi Microsoft.ApplicationServer.Caching.

Avviso

Non è consigliabile installare Microsoft AppFabric 1.1 per Windows Server e Microsoft Azure Cache nello stesso computer. Questo vale sia per il prodotto sia per l'SDK. È possibile fare riferimento erroneamente ad alcuni degli assembly di Microsoft AppFabric 1.1 per Windows Server nella Global Assembly Cache. Questo potrebbe causare comportamenti errati o imprevisti.

Per specificare come destinazione la versione corretta di .NET Framework

  1. Aprire il progetto di Visual Studio.

  2. In Esplora soluzioni fare clic con il pulsante destro del mouse sul nome del progetto, quindi scegliere Proprietà.

  3. Per un progetto Visual C#, procedere nel modo seguente:

    1. Fare clic sulla scheda Applicazione della finestra di dialogo Proprietà progetto.

    2. Verificare che la destinazione sia .NET Framework 2.0 o versioni successive (non Client Profile).

  4. Per un progetto Visual Basic, procedere nel modo seguente:

    1. Selezionare la sezione Compilazione della finestra di dialogo Proprietà progetto.

    2. Nella parte inferiore della pagina Compilazione fare clic sul pulsante Opzioni di compilazione avanzate.

    3. Verificare che la destinazione sia .NET Framework 2.0 o versioni successive (non Client Profile).

Importante

Non usare Client Profile per la versione di .NET Framework di destinazione. In Visual Studio selezionare versioni di .NET Framework che non specificano "Profilo client".

Configurare un progetto per Caching basato su ruoli

Per aggiungere i riferimenti all'assembly, è necessario che l'SDK di Azure sia installato nel computer. Per istruzioni, vedere Download di Azure SDK.

Nei passaggi che seguono viene usato un pacchetto NuGet per aggiungere i riferimenti agli assembly e le modifiche alla configurazione necessari. Questi passaggi sono specifici dell'uso di In-Role Cache ospitata in un ruolo di Azure nella stessa distribuzione.

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul nome del progetto, quindi scegliere Aggiungi riferimento al pacchetto di librerie (NuGet 1.2) oppure Gestisci pacchetti NuGet (NuGet 2.0 o versioni successive).

  2. Nel riquadro a sinistra selezionare la categoria Online.

  3. Cercare WindowsAzure.Caching.

  4. Installare il pacchetto cache In-Role denominato Microsoft.WindowsAzure.Caching (NuGet 1.2) o Azure Caching (NuGet 2.0 o versione successiva).

    Screenshot of Caching Preview Package (NuGet 1.2)

    Screenshot of Caching Preview Package (NuGet 2.0)

Oltre ad aggiungere i riferimenti agli assembly appropriati, questo pacchetto modifica il file di configurazione (app.config o web.config) per il progetto di destinazione Aggiunge una sezione dataCacheClient di boilerplate simile alla seguente.

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

Il passaggio finale consiste nel modificare l'attributo identificatore da "[cache cluster role name]" al nome effettivo del ruolo con In-Role cache abilitata. In una topologia basata su risorse condivise il ruolo può essere lo stesso, ad esempio "WebRole1", mentre in una topologia dedicata il ruolo può essere diverso, ad esempio "CacheWorkerRole1". Per esempi di entrambe le topologie, vedere Esempi di cache di Azure In-Role.

Nota

Se questa sezione è stata personalizzata, la disinstallazione del pacchetto NuGet non rimuove la sezione dataCacheClients. Questa deve essere rimossa manualmente.

Il pacchetto NuGet aggiunge riferimenti ai seguenti assembly:

  • 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

È possibile definire manualmente i riferimenti a questi assembly senza usare il pacchetto NuGet. Per impostazione predefinita, vengono installati in C:\Programmi\Microsoft SDK\Azure\.NET SDK&lt;versione> corrente\ref\Caching.

Vedere anche

Concetti

Sviluppare per Cache nel ruolo di Azure
Provider di cache ASP.NET 4 per Cache nel ruolo di Azure