Delen via


Azure Storage toevoegen met behulp van Visual Studio Connected Services

Met Visual Studio kunt u een van de volgende verbindingen maken met Azure Storage met behulp van de functie Connected Services:

  • .NET Framework Console App
  • ASP.NET Model-View-Controller (MVC) (.NET Framework)
  • ASP.NET Core
  • .NET Core (inclusief console app, WPF, Windows Forms, class library)
  • .NET Core Werkrol
  • Azure Functions
  • Universele Windows Platform-app
  • Xamarin
  • Córdoba

De functionaliteit van de verbonden service voegt alle benodigde verwijzingen en verbindingscode toe aan uw project en wijzigt uw configuratiebestanden op de juiste manier.

Voorwaarden

Verbinding maken met Azure Storage met behulp van verbonden services

  1. Open uw project in Visual Studio.

  2. Klik in Solution Explorermet de rechtermuisknop op het knooppunt Connected Services en selecteer in het contextmenu Verbonden service toevoegen.

    Schermafbeelding van het scherm

  3. Klik op het tabblad Verbonden services op het + pictogram voor Serviceafhankelijkheden.

    Schermopname van het scherm 'Serviceafhankelijkheid toevoegen'.

  4. Selecteer op de pagina Afhankelijkheid toevoegen de optie Azure Storage.

    Schermopname van het scherm 'Azure Storage toevoegen'.

    Als u nog niet bent aangemeld, meldt u zich aan bij uw Azure-account. Als u geen Azure-account hebt, kunt u zich aanmelden voor een gratis proefversie van .

  5. Selecteer een bestaand opslagaccount in het scherm Azure Storage configureren en selecteer Volgende.

    Als u een opslagaccount moet maken, gaat u naar de volgende stap. Sla anders stap 6 over.

    Schermopname met het scherm 'Bestaand opslagaccount toevoegen aan project'.

  6. Een opslagaccount maken:

    1. Selecteer Een opslagaccount maken onder aan het dialoogvenster.

    2. Vul het dialoogvenster Azure Storage in: maak een nieuw en selecteer maken.

      Schermopname van het scherm 'Nieuw Azure Storage-account'.

    3. Wanneer het dialoogvenster Azure Storage wordt weergegeven, wordt het nieuwe opslagaccount weergegeven in de lijst. Selecteer het nieuwe opslagaccount in de lijst en selecteer Volgende.

  7. Voer een verbindingsreeksnaam in en kies of u de verbindingsreeks wilt opslaan in een lokaal geheimenbestand of in Azure Key Vault-.

    Schermopname met het scherm

  8. In het scherm Samenvatting van wijzigingen worden alle wijzigingen weergegeven die in uw project worden aangebracht als u het proces voltooit. Als de wijzigingen er OK uitzien, kies voltooien.

    Schermopname van het scherm

  9. De verbonden opslagservice wordt weergegeven onder het knooppunt Connected Services van uw project.

  1. Open uw project in Visual Studio.

  2. Druk op Ctrl+Q (of gebruik de knop Search in de Visual Studio IDE rechts van de hoofdmenubalk).

  3. In Zoekfunctievoert u Azure Storagein en kiest u Azure Storage - Project > Connected Services > Toevoegen > Azure Storage.

    schermopname van het gebruik van Functie zoeken om te zoeken naar Azure Storage.

  4. Selecteer op de pagina Verbinding maken met afhankelijkheidAzure Storageen selecteer vervolgens Volgende.

    schermopname van het maken van verbinding met afhankelijkheid - Azure Storage.

    Als u nog niet bent aangemeld, meldt u zich aan bij uw Azure-account. Als u geen Azure-account hebt, kunt u zich aanmelden voor een gratis proefversie van .

  5. Selecteer in het scherm Verbinding maken met Azure Storage een bestaand opslagaccount en kies Volgende.

    Als u een opslagaccount moet maken, gaat u naar de volgende stap. Ga anders verder met de volgende stap.

    schermopname van het toevoegen van een bestaand opslagaccount aan een project.

  6. Een opslagaccount maken:

    1. Selecteer Nieuwe maken met het groene plusteken.

    2. Vul het dialoogvenster Azure Storage in: maak een nieuw en selecteer maken.

      nieuw Azure Storage-account.

    3. Wanneer het dialoogvenster Azure Storage wordt weergegeven, wordt het nieuwe opslagaccount weergegeven in de lijst. Selecteer het nieuwe opslagaccount in de lijst en selecteer Volgende.

  7. Voer een naam in voor de instelling van een verbindingsreeks. De naam van de instelling verwijst naar de naam van de verbindingsreeksinstelling zoals deze wordt weergegeven in het secrets.json-bestand of in Azure Key Vault.

    Schermopname waarin wordt getoond hoe u de verbindingsreeks opgeeft.

  8. Kies of u de verbindingsreeks wilt opslaan in een lokaal geheimenbestand, in Azure Key Vault-of nergens wilt opslaan.

    Schermopname met opties voor het opslaan van de verbindingsinstellingen.

    Voorzichtigheid

    Als u een versie van Visual Studio gebruikt die ouder is dan Visual Studio 17.12 en u ervoor kiest om een secrets.json-bestand te gebruiken, moet u beveiligingsmaatregel nemen, omdat de verbindingsreeks in het lokale secrets.json-bestand beschikbaar kan worden gemaakt. Als u Visual Studio 2022 versie 17.12 of hoger gebruikt, produceert deze procedure een veiliger resultaat, omdat dit een waarde voor een verbindingsinstelling oplevert in plaats van een verbindingsreeks met verificatiereferenties.

  9. In het scherm Samenvatting van wijzigingen worden alle wijzigingen weergegeven die in uw project worden aangebracht als u het proces voltooit. Als de wijzigingen er OK uitzien, kiest u voltooien.

    Schermopname met de samenvatting van wijzigingen.

  10. De verbonden opslagservice wordt weergegeven onder het knooppunt Connected Services van uw project.

Verificatie begrijpen

Nadat u de vorige procedure hebt uitgevoerd, is uw app ingesteld om verificatie te gebruiken voor toegang tot het opslagaccount. De verbindingsgegevens voor deze verificatie worden lokaal opgeslagen, als u de secrets.json methode of in uw Azure-sleutelkluis hebt gekozen.

Als u het secrets.json-bestand hebt gebruikt, opent u het bestand met de drie puntjes naast Secrets.json op het tabblad Verbonden services om een menu te openen en kiest u Gebruikersgeheimen beheren. Met Visual Studio 2022 versie 17.12 en hoger bevat dit bestand instellingen die verwijzen naar een URI om de beveiligde verbindingsreeks te verkrijgen, in plaats van de verbindingsreeks zelf.

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

Met deze instellingen in Visual Studio 17.12 en hoger is verificatie automatisch en flexibel. Wanneer u vanuit Visual Studio lokaal uitvoert of fouten opspoort, worden uw Azure-referenties die door Visual Studio zijn opgeslagen, gebruikt voor toegang tot het Azure Storage-account. Als u uw app start vanaf de opdrachtregel, moet u zich eerst aanmelden met de Azure CLI en worden deze referenties automatisch gedetecteerd en gebruikt. Maar wanneer uw app wordt geïmplementeerd in Azure en wordt uitgevoerd in Azure, wordt er gebruikgemaakt van een beheerde identiteit, zonder dat er codewijzigingen zijn aangebracht. De authenticatie werkt in alle hostingomgevingen omdat de Azure Identity-API's alle gekoppelde referenties in volgorde controleert en deze gebruiken zodra deze gevonden worden. Zie DefaultAzureCredential.

Volgende stappen

Azure Storage ondersteunt blobs en wachtrijen, evenals andere functies.

Als u meer wilt weten over het werken met blobs, kunt u doorgaan met de quickstart voor blobopslag, maar in plaats van aan het begin te beginnen, kunt u beginnen bij quickstart voor Azure-blobs (.NET): codevoorbeelden.

Als u meer wilt weten over het werken met wachtrijen, begint u bij quickstart voor Azure Queue Storage (.NET): codevoorbeelden.