Lägga till Azure Storage med hjälp av Visual Studio Connected Services

Med Visual Studio kan du ansluta något av följande till Azure Storage med hjälp av funktionen Connected Services:

• .NET Framework-konsolapp
• ASP.NET Model –View-Controller (MVC) (.NET Framework)
• ASP.NET Core
• .NET Core (inklusive konsolapp, WPF, Windows Forms, klassbibliotek)
• .NET Core Worker Role
• Azure Functions
• Universell Windows-plattformsapp
• Xamarin
• Cordova

Den anslutna tjänstfunktionen lägger till alla nödvändiga referenser och anslutningskod till projektet och ändrar konfigurationsfilerna på rätt sätt.

Förutsättningar

• Visual Studio (se [Visual Studio-nedladdningar] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)) med arbetsbelastningen Azure-utveckling installerad.
• Ett projekt av någon av de typer som stöds
• Ett Azure-konto. Om du inte har något Azure-konto aktiverar du dina Azure-förmåner för Visual Studio-prenumeranter eller registrera dig för en kostnadsfri utvärderingsversion.

Ansluta till Azure Storage med hjälp av anslutna tjänster

1. Öppna projektet i Visual Studio.

2. Tryck på Ctrl+Q (eller använd knappen Sök i Visual Studio IDE till höger om huvudmenyfältet).

3. I Funktionssökninganger du Azure Storageoch väljer Azure Storage – Project > Connected Services > Add > Azure Storage.

   

4. På sidan Anslut till beroende väljer du Azure Storageoch väljer sedan Nästa.

   

   Om du inte redan är inloggad loggar du in på ditt Azure-konto. Om du inte har något Azure-konto kan du registrera dig för en kostnadsfri utvärderingsversion.

5. På skärmen Anslut till Azure Storage väljer du ett befintligt lagringskonto och väljer Nästa.

   Om du behöver skapa ett lagringskonto går du till nästa steg. Annars går du vidare till följande steg.

   

6. Så här skapar du ett lagringskonto:

   1. Välj Skapa ny med det gröna plustecknet.

   2. Fyll i dialogrutan Azure Storage: Skapa ny och klicka på Skapa.

      

   3. När dialogrutan Azure Storage visas visas det nya lagringskontot i listan. Välj det nya lagringskontot i listan och välj Nästa.

7. Ange ett namn på anslutningssträngsinställningen. Inställningsnamnet refererar till namnet på anslutningssträngsinställningen så som den visas i filen secrets.json eller i Azure Key Vault.

   

8. Välj om du vill att anslutningssträngen ska lagras i en lokal hemlighetsfil, i Azure Key Vault-eller inte lagras någonstans.

   

   Försiktighet

   Om du använder en tidigare version av Visual Studio än Visual Studio 17.12 och väljer att använda en secrets.json fil måste du vidta säkerhetsåtgärder eftersom anslutningssträngen i den lokala secrets.json filen kan exponeras. Om du använder Visual Studio 2022 version 17.12 eller senare ger den här proceduren ett säkrare resultat eftersom det ger ett anslutningsinställningsvärde i stället för en anslutningssträng med autentiseringsuppgifter.

9. Skärmen Sammanfattning av ändringar visar alla ändringar som kommer att göras i projektet om du slutför processen. Om ändringarna ser OK ut väljer du Slutför.

   

10. Den lagringsanslutna tjänsten visas under noden Anslutna tjänster i projektet.

Förstå autentisering

När du har kört föregående procedur konfigureras appen för att använda autentisering för att komma åt lagringskontot. Anslutningsinformationen för den här autentiseringen lagras lokalt, om du väljer metoden secrets.json eller i ditt Azure-nyckelvalv.

Om du använde filen secrets.json öppnar du filen med hjälp av de tre punkterna bredvid Secrets.json på fliken Anslutna tjänster för att öppna en meny och väljer Hantera användarhemligheter. Med Visual Studio 2022 version 17.12 och senare innehåller den här filen inställningar som refererar till en URI för att hämta den säkra anslutningssträngen i stället för själva anslutningssträngen.

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

Med de här inställningarna i Visual Studio 17.12 och senare är autentiseringen automatisk och flexibel. När du kör eller felsöker lokalt från Visual Studio används dina Azure-autentiseringsuppgifter som sparats av Visual Studio för att komma åt Azure Storage-kontot. Om du startar appen från kommandoraden måste du först logga in med Hjälp av Azure CLI, och dessa autentiseringsuppgifter identifieras och används automatiskt. Men när din app distribueras till Azure och körs i Azure använder den hanterad identitet, utan några kodändringar. Autentiseringen fungerar i alla värdmiljöer eftersom Azure Identity-API:erna söker efter alla länkade autentiseringsuppgifter i sekvens och använder dem när de hittas. Se DefaultAzureCredential.

Nästa steg

Azure Storage stöder blobar och köer samt andra funktioner.

Om du vill lära dig mer om att arbeta med blobar kan du fortsätta med snabbstarten för bloblagring, men i stället för att börja i början kan du börja med snabbstarten Azure Blobs (.NET) – Kodexempel.

Om du vill veta mer om hur du arbetar med köer börjar du med snabbstarten Azure Queue Storage (.NET) – Kodexempel.

Relaterat innehåll

• Azure Storage-forum
• Dokumentation om Azure Storage