Condividi tramite


Aggiungere Archiviazione di Azure utilizzando i Servizi Connessi di Visual Studio

Con Visual Studio è possibile connettere una delle seguenti a Azure Storage usando la funzionalità Connected Services:

  • Applicazione console .NET Framework
  • ASP.NET Modello -View-Controller (MVC) (.NET Framework)
  • ASP.NET Core
  • .NET Core (inclusa l'app console, WPF, Windows Form, libreria di classi)
  • Ruolo di lavoro .NET Core
  • Funzioni di Azure
  • Applicazione Universal Windows Platform (UWP)
  • Cordova

La funzionalità del servizio connesso aggiunge tutti i riferimenti e il codice di connessione necessari al progetto e modifica i file di configurazione in modo appropriato.

Prerequisiti

Connettersi ad Azure Storage utilizzando il servizio connesso

  1. Aprire il progetto in Visual Studio.

  2. In Esplora Soluzioni, fare clic con il pulsante destro del mouse sul nodo Servizi Connessi e, dal menu di scelta rapida, scegliere Aggiungi Servizio Connesso.

    screenshot che mostra la schermata

  3. Nella scheda Servizi Connessi, selezionare l'icona + per Dipendenze del Servizio.

    La schermata

  4. Nella pagina Aggiungi Dipendenza, selezionare Archiviazione di Azure.

    screenshot che mostra la schermata

    Se non hai già effettuato l'accesso, accedi al tuo account Azure. Se non si ha un account Azure, è possibile iscriversi per ottenere una versione di valutazione gratuita .

  5. Nella schermata Configura archiviazione di Azure selezionare un account di archiviazione esistente e selezionare Avanti.

    Se è necessario creare un account di archiviazione, andare al passaggio successivo. Altrimenti, passare al passaggio 6.

    Schermata che mostra

  6. Per creare un account di archiviazione:

    1. Selezionare Crea un account di archiviazione nella parte inferiore della finestra di dialogo.

    2. Compilare la finestra di dialogo Archiviazione di Azure: Crea un nuovo e selezionare Crea.

      screenshot che mostra la schermata

    3. Quando viene visualizzata la finestra di dialogo Archiviazione di Azure, il nuovo account di archiviazione appare nell'elenco. Selezionare il nuovo account di archiviazione nell'elenco e selezionare Avanti.

  7. Immettere un nome di stringa di connessione e scegliere se si vuole archiviare la stringa di connessione in un file di segreti locale o in Azure Key Vault.

    screenshot che mostra la schermata

  8. La schermata Riepilogo delle modifiche mostra tutte le modifiche che verranno apportate al progetto se si completa il processo. Se le modifiche sono ok, scegliere Fine.

    screenshot che mostra la schermata

  9. Il servizio connesso di archiviazione viene visualizzato nel nodo Servizi connessi del progetto.

  1. Aprire il progetto in Visual Studio.

  2. Premere CTRL+Q oppure usare il pulsante ricerca nell'IDE di Visual Studio a destra della barra dei menu principale.

  3. In Ricerca funzionalità, immettere Azure Storage, e scegliere Archiviazione di Azure - Progetto > Servizi connessi > Aggiungi > Archiviazione di Azure.

    Screenshot dell'uso della Ricerca di funzionalità per cercare l'Archiviazione di Azure.

  4. Nella pagina Connetti alla dipendenza, selezionare Archiviazione di Azure, poi selezionare Avanti.

    Screenshot che mostra il collegamento alla dipendenza - Archiviazione di Azure.

    Se non hai già effettuato l'accesso, accedi al tuo account Azure. Se non si ha un account Azure, è possibile iscriversi per ottenere una versione di valutazione gratuita .

  5. Nella schermata Connetti ad Archiviazione di Azure, selezionare un account di archiviazione esistente e selezionare Avanti.

    Se è necessario creare un account di archiviazione, andare al passaggio successivo. In caso contrario, passare al passaggio seguente.

    Screenshot che mostra l'aggiunta di un account di archiviazione esistente al progetto.

  6. Per creare un account di archiviazione:

    1. Seleziona Crea nuovo facendo clic sul pulsante con il segno più verde.

    2. Compilare la finestra di dialogo Archiviazione di Azure: Crea un nuovo e selezionare Crea.

      Nuovo account di archiviazione di Azure.

    3. Quando viene visualizzata la finestra di dialogo Archiviazione di Azure, il nuovo account di archiviazione appare nell'elenco. Selezionare il nuovo account di archiviazione nell'elenco e selezionare Avanti.

  7. Immettere un nome di impostazione della stringa di connessione. Il nome dell'impostazione fa riferimento al nome dell'impostazione della stringa di connessione così come viene visualizzato nel file secrets.json o in Azure Key Vault.

    Screenshot che mostra come specificare la stringa di connessione.

  8. Scegli se vuoi che la stringa di connessione venga archiviata in un file di segreti locali, in Azure Key Vault, o non venga archiviata affatto.

    Screenshot che mostra le opzioni per l'archiviazione delle impostazioni di connessione.

    Cautela

    Se si usa una versione di Visual Studio precedente a Visual Studio 17.12 e si sceglie di usare un file secrets.json, è necessario adottare precauzioni di sicurezza, poiché la stringa di connessione nel file locale secrets.json potrebbe essere esposta. Se si usa Visual Studio 2022 versione 17.12 o successiva, questa procedura produce risultati più sicuri, perché restituisce un valore di impostazione di connessione, anziché una stringa di connessione con credenziali di autenticazione.

  9. La schermata Riepilogo delle modifiche mostra tutte le modifiche che verranno apportate al progetto se si completa il processo. Se le modifiche sono ok, scegliere Fine.

    Screenshot che mostra il riepilogo delle modifiche.

  10. Il servizio connesso di archiviazione viene visualizzato nel nodo Servizi connessi del progetto.

Informazioni sull'autenticazione

Dopo aver eseguito la procedura precedente, l'app è configurata per usare l'autenticazione per accedere all'account di archiviazione. Le informazioni di connessione per questa autenticazione vengono archiviate in locale, se si sceglie il metodo secrets.json o in Azure Key Vault.

Se è stato usato il file secrets.json, aprire il file usando i tre puntini accanto a Secrets.json nella scheda Servizi connessi per aprire un menu e scegliere Gestisci segreti utente. Con Visual Studio 2022 versione 17.12 e successive, questo file contiene impostazioni che fanno riferimento a un URI per ottenere la stringa di connessione sicura, anziché la stringa di connessione stessa.

{
  "StorageConnection:blobServiceUri": "https://webapplication16storagex.blob.core.windows.net/",
  "StorageConnection:queueServiceUri": "https://webapplication16storagex.queue.core.windows.net/",
  "StorageConnection:tableServiceUri": "https://webapplication16storagex.table.core.windows.net/"
}

Con queste impostazioni in Visual Studio 17.12 e versioni successive, l'autenticazione è automatica e flessibile. Quando si esegue o si esegue il debug in locale da Visual Studio, le credenziali di Azure salvate da Visual Studio vengono usate per accedere all'account di archiviazione di Azure. Se si avvia l'app dalla riga di comando, è prima necessario accedere usando l'interfaccia della riga di comando di Azure e tali credenziali vengono rilevate e usate automaticamente. Tuttavia, quando l'app viene distribuita in Azure ed eseguita in Azure, usa l'identità gestita, senza modifiche al codice. L'autenticazione funziona in tutti gli ambienti di hosting perché le API di identità di Azure controllano la presenza di tutte le credenziali concatenati in sequenza e le usano quando vengono trovate. Vedere DefaultAzureCredential.

Passaggi successivi

Azure Storage supporta Blob e code, nonché altre funzionalità.

Per informazioni sull'uso dei BLOB, è possibile continuare con la guida introduttiva per l'archiviazione BLOB, ma invece di iniziare all'inizio, è possibile iniziare a guida introduttiva ai BLOB di Azure (.NET) - Esempi di codice.

Per informazioni sull'uso delle code, inizia con Azure Queue Storage - Introduzione rapida (.NET) - Esempi di codice.