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
- Visual Studio (zie [Visual Studio-downloads] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)) met de Azure-ontwikkeling workload geïnstalleerd.
- Een project van een van de ondersteunde typen
- Een Azure-account. Als u geen Azure-account hebt, activeert u uw Azure-voordelen voor Visual Studio-abonnees of u aan te melden voor een gratis proefversie.
Verbinding maken met Azure Storage met behulp van verbonden services
Open uw project in Visual Studio.
Klik in Solution Explorermet de rechtermuisknop op het knooppunt Connected Services en selecteer in het contextmenu Verbonden service toevoegen.
Klik op het tabblad Verbonden services op het + pictogram voor Serviceafhankelijkheden.
Selecteer op de pagina Afhankelijkheid toevoegen de optie 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 .
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.
Een opslagaccount maken:
Selecteer Een opslagaccount maken onder aan het dialoogvenster.
Vul het dialoogvenster Azure Storage in: maak een nieuw en selecteer maken.
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.
Voer een verbindingsreeksnaam in en kies of u de verbindingsreeks wilt opslaan in een lokaal geheimenbestand of in Azure Key Vault-.
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.
De verbonden opslagservice wordt weergegeven onder het knooppunt Connected Services van uw project.
Open uw project in Visual Studio.
Druk op Ctrl+Q (of gebruik de knop Search in de Visual Studio IDE rechts van de hoofdmenubalk).
In Zoekfunctievoert u
Azure Storage
in en kiest u Azure Storage - Project > Connected Services > Toevoegen > Azure Storage.Selecteer op de pagina Verbinding maken met afhankelijkheidAzure Storageen selecteer vervolgens Volgende.
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 .
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.
Een opslagaccount maken:
Selecteer Nieuwe maken met het groene plusteken.
Vul het dialoogvenster Azure Storage in: maak een nieuw en selecteer maken.
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.
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.
Kies of u de verbindingsreeks wilt opslaan in een lokaal geheimenbestand, in Azure Key Vault-of nergens wilt opslaan.
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.
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.
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.