Condividi tramite


Aggiunta dell'archiviazione di Azure tramite Servizi connessi di Visual Studio

Con Visual Studio è possibile connettere uno dei seguenti elementi a Archiviazione di Azure usando la funzionalità Servizi connessi:

  • App console .NET Framework
  • ASP.NET Model-View-Controller (MVC) (.NET Framework)
  • ASP.NET Core
  • .NET Core (tra cui app console, WPF, Windows Form, libreria di classi)
  • Ruolo di lavoro .NET Core
  • Funzioni di Azure
  • app piattaforma UWP (Universal Windows Platform)
  • Xamarin
  • Cordova

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

Prerequisiti

Connettersi a Archiviazione di Azure tramite Servizi connessi

  1. Aprire il progetto in Visual Studio.

  2. In Esplora soluzioni fare clic con il pulsante destro del mouse sul nodo Servizi connessi e scegliere Aggiungi servizio connesso dal menu di scelta rapida.

    Screenshot che mostra la schermata

  3. Nella scheda Servizi connessi selezionare l'icona + per Dipendenze del servizio.

    Screenshot che mostra la schermata

  4. Nella pagina Aggiungi dipendenza selezionare Archiviazione di Azure.

    Screenshot che mostra la schermata

    Se non è già stato eseguito l'accesso, accedere all'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. In caso contrario, andare al passaggio 6.

    Screenshot che mostra la schermata

  6. Per creare un account di archiviazione:

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

    2. Compilare il Archiviazione di Azure: Crea nuovo dialogo e selezionare Crea.

      Screenshot che mostra la schermata

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

  7. Immettere un nome stringa di connessione e scegliere se si vuole archiviare il 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 hanno un aspetto 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 Cerca nell'IDE di Visual Studio a destra della barra dei menu principale.

  3. In Ricerca funzionalità immettere Azure Storagee scegliere Archiviazione di Azure - Project > Connected Services > Aggiungi > Archiviazione di Azure.

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

  4. Nella pagina Connetti alla dipendenza selezionare Archiviazione di Azure e quindi selezionare Avanti.

    Screenshot che mostra la connessione alla dipendenza- Archiviazione di Azure.

    Se non è già stato eseguito l'accesso, accedere all'account Azure. Se non si ha un account Azure, è possibile iscriversi per ottenere una versione di valutazione gratuita.

  5. Nella schermata Connetti a 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. Selezionare Crea nuovo con il segno più verde.

    2. Compilare il Archiviazione di Azure: Crea nuovo dialogo e selezionare Crea.

      Nuovo account Archiviazione di Azure.

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

  7. Immettere un nome di impostazione stringa di connessione. Il nome dell'impostazione fa riferimento al nome dell'impostazione stringa di connessione visualizzata nel file secrets.json o in Azure Key Vault.

    Screenshot che mostra come specificare il stringa di connessione.

  8. Scegliere se si vuole che il stringa di connessione archiviato in un file di segreti locali, in Azure Key Vault o non sia archiviato in qualsiasi posizione.

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

    Attenzione

    Se si usa una versione di Visual Studio precedente a Visual Studio 17.12 e si sceglie di usare un file di secrets.json, è necessario adottare precauzioni di sicurezza, poiché il stringa di connessione nel file secrets.json locale potrebbe essere esposto. 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é un 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 hanno un aspetto 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 nell'insieme di credenziali delle chiavi di Azure.

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 le impostazioni che fanno riferimento a un URI per ottenere il stringa di connessione sicuro, anziché il stringa di connessione stesso.

{
  "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

Archiviazione di Azure supporta BLOB e code, nonché altre funzionalità.

Per informazioni sull'uso dei BLOB, è possibile continuare con l'avvio rapido per l'archiviazione BLOB, ma invece di iniziare dall'inizio, è possibile iniziare con l'avvio rapido dei BLOB di Azure (.NET) - Esempi di codice.

Per informazioni sull'uso delle code, vedere Avvio rapido di Archiviazione code di Azure (.NET) - Esempi di codice.