Quickstart: Een C#-functie maken in Azure met behulp van Visual Studio Code

  • Artikel
  • 7 minuten om te lezen

In dit artikel gebruikt u Visual Studio Code om een op een C#-klassenbibliotheek gebaseerde functie te maken die reageert op HTTP-aanvragen. Nadat u de code lokaal hebt getest, implementeert u deze in de serverloos omgeving van Azure Functions.

Voor het voltooien van deze quickstart worden kosten van een paar dollarcent of minder in rekening gebracht bij uw Azure-account.

Er is ook een op een CLI gebaseerde versie van dit artikel.

1. Uw omgeving configureren

Voordat u aan de slag kunt gaan, moet u beschikken over de volgende vereisten:

2. Uw lokale project maken

In deze sectie gebruikt u Visual Studio Code om een lokale te maken Azure Functions project in C#. Verderop in dit artikel publiceert u de functiecode in Azure.

  1. Kies het Azure-pictogram in de Activiteitenbalkselecteert u vervolgens in het gebied Azure: Functions het pictogram Nieuw project maken... .

    Een nieuw project maken kiezen

  2. Kies een maplocatie voor de werkruimte van uw project en kies Selecteren.

    Notitie

    Deze stappen waren bedoeld om buiten een werkruimte te worden voltooid. Selecteer in dit geval geen projectmap die deel uitmaakt van een werkruimte.

  3. Geef de volgende informatie op bij de prompts:

    • Selecteer een taal voor uw functieproject: Kies C#.

    • Selecteer een sjabloon voor de eerste functie van uw project: Kies HTTP trigger.

    • Geef een functienaam op: Typ HttpExample.

    • Geef een naamruimte op: Typ My.Functions.

    • Autorisatieniveau: Kies Anonymous, waarmee iedereen uw functie-eindpunt kan aanroepen. Zie Autorisatiesleutels voor meer informatie over autorisatieniveaus.

    • Selecteer hoe u uw project wilt openen: Kies Add to workspace.

  4. Met behulp van deze informatie genereert Visual Studio Code een Azure Functions project met een HTTP activeren. U kunt de lokale projectbestanden weergeven in de Explorer. Zie Gegenereerde projectbestanden voor meer informatie over bestanden die worden gemaakt.

De functie lokaal uitvoeren

Visual Studio Code integreert met Azure Functions Core Tools om u een project te laten uitvoeren vanaf uw lokale ontwikkelaarscomputer voordat u in Azure publiceert.

  1. Druk op F5 om het functie-app-project te starten en uw functie aan te roepen. De uitvoer van Core Tools wordt weergegeven in het deelvenster Terminal. Uw app wordt gestart in het deelvenster Terminal. Kopieer het URL-eindpunt van uw functie die lokaal wordt uitgevoerd en door HTTP is geactiveerd.

    Lokale functie versus code-uitvoer

    Als u problemen ondervindt met het uitvoeren op Windows, moet u ervoor zorgen dat de standaardterminal voor Visual Studio Code niet is ingesteld op WSL Bash.

  2. Als Core Tools wordt uitgevoerd, gaat u naar het gebied Azure: Functions. Vouw onder Functies de functie Lokaal Project > functies uit. Klik met de rechtermuisknop (Windows) of Ctrl- klik (macOS) op de functie en HttpExample kies Functie nu uitvoeren....

    Functie nu uitvoeren vanuit Visual Studio Code

  3. In Aanvraag body invoeren ziet u de waarde van de aanvraagbericht-body van { "name": "Azure" } . Druk op Enter om dit aanvraagbericht naar uw functie te verzenden.

  4. Wanneer de functie lokaal wordt uitgevoerd en een antwoord retourneert, wordt er een melding in Visual Studio code. Informatie over de uitvoering van de functie wordt weergegeven in het deelvenster Terminal.

  5. Druk op CTRL + C om Core Tools te stoppen en de verbinding met het foutopsporingsprogramma te verbreken.

Nadat u hebt gecontroleerd of de functie correct wordt uitgevoerd op uw lokale computer, is het tijd om het project te publiceren in Azure met behulp van Visual Studio Code.

Aanmelden bij Azure

Voordat u de app kunt publiceren, moet u zich aanmelden bij Azure.

  1. Als u niet al bent aangemeld, kiest u het Azure-pictogram in de activiteitenbalk en selecteert u vervolgens in het gedeelte Azure: Functions Aanmelden bij Azure... . Hier kunt u een gratis Azure-account maken als u dat nog niet hebt. Studenten kunnen een gratis Azure-account voor studenten maken .

    Aanmelden bij Azure binnen VS Code

    Als u al bent aangemeld, gaat u naar het volgende gedeelte.

  2. Wanneer u hierom wordt gevraagd in de browser, kiest u uw Azure-account en meld u zich aan met uw Azure-accountreferenties.

  3. Nadat u bent aangemeld, kunt u het nieuwe browservenster sluiten. De abonnementen die bij uw Azure-account horen, worden weergegeven in de zijbalk.

5. Het project publiceren naar Azure

In deze sectie maakt u een functie-app en de bijbehorende resources in uw Azure-abonnement en implementeert u vervolgens uw code.

Belangrijk

Als u in een bestaande functie-app publiceert, wordt de inhoud van die app in Azure overschreven.

  1. Kies het Azure-pictogram in de activiteitenbalk en selecteer vervolgens in het gedeelte Azure: In het gebied Functies kiest u de knop Implementeren in functie-app ... .

  2. Geef de volgende informatie op bij de prompts:

    • Selecteer map: Kies een map in uw werkruimte of blader naar een map die de functie-app bevat. Dit wordt niet weergegeven als u al een geldige functie-app hebt geopend.

    • Selecteer abonnement: Kies het abonnement dat u wilt gebruiken. Dit ziet u niet als u maar één abonnement hebt.

    • Selecteer functie-app in Azure: Kies + Create new Function App. (Kies niet de optie Advanced die niet in dit artikel wordt behandeld.)

    • Voer een globaal unieke naam in voor de functie-app: Typ een naam die geldig is in een URL-pad. De naam die u typt, wordt gevalideerd om ervoor te zorgen dat deze uniek in Azure Functions.

    • Selecteer een locatie voor nieuwe resources: Kies voor betere prestaties een regio bij u in de buurt.

    De extensie toont de status van afzonderlijke resources terwijl deze in het systeemgebied in Azure worden gemaakt.

    Melding over het maken van Azure-resources

  3. Wanneer dit is voltooid, worden de volgende Azure-resources in uw abonnement gemaakt met behulp van namen op basis van de naam van uw functie-app:

    • Een resourcegroep, een logische container voor gerelateerde resources.
    • Een standaardaccount Azure Storage, waarmee de status en andere informatie over uw projecten worden onderhouden.
    • Een verbruiksplan waarmee de onderliggende host voor uw serverloze functie-app wordt bepaald.
    • Een functie-app, die de omgeving biedt voor het uitvoeren van uw functiecode. Met een functie-app kunt u functies groeperen in een logische eenheid, zodat u resources eenvoudiger kunt beheren, implementeren en delen binnen hetzelfde hostingabonnement.
    • Een Application Insights-exemplaar dat is verbonden met de functie-app, die het gebruik van uw serverloze functie bij houdt.

    Nadat de functie-app is gemaakt en het implementatiepakket is toegepast, wordt er een melding weergegeven.

    Tip

    Standaard worden de Azure-resources die vereist zijn voor uw functie-app gemaakt op basis van de naam van de functie-app die u op geeft. Standaard worden ze ook in dezelfde nieuwe resourcegroep gemaakt met de functie-app. Als u de namen van deze resources wilt aanpassen of bestaande resources opnieuw wilt gebruiken, moet u in plaats daarvan het project publiceren met geavanceerde opties voor maken.

  4. Selecteer in deze melding de optie Uitvoer weergeven om de resultaten van het maken en implementeren te bekijken, inclusief de Azure-resources die u hebt gemaakt. Als u de melding mist, selecteert u het belpictogram in de rechterbenedenhoek om deze opnieuw weer te geven.

    Volledige melding maken

6. De functie uitvoeren in Azure

  1. Vouw in het gebied Azure: Functions in de zijbalk uw abonnement, uw nieuwe functie-app en Functions uit. Klik met de rechtermuisknop (Windows) of Ctrl- klik (macOS) op de functie en HttpExample kies Functie nu uitvoeren....

    Functie nu uitvoeren in Azure vanuit Visual Studio Code

  2. In Aanvraag body invoeren ziet u de waarde van de aanvraagbericht-body van { "name": "Azure" } .

    Druk op Enter om dit aanvraagbericht naar uw functie te verzenden.

  3. Wanneer de functie wordt uitgevoerd in Azure en een antwoord retourneert, wordt er een melding in Visual Studio code.

5. Resources ops schonen

Wanneer u verder gaat met de volgende stap en een toevoegt Azure Storage wachtrijuitvoerbinding voor uw functie moet u al uw resources behouden om voort te bouwen op wat u al hebt gedaan.

Als dat niet het geval is, kunt u de volgende stappen gebruiken om de functie-app en de bijbehorende resources te verwijderen om te voorkomen dat er verdere kosten in rekening worden gebracht.

  1. Druk in Visual Studio Code op F1 om het opdrachtenpalet te openen. In het opdrachtenpalet zoekt en selecteert u Azure Functions: Open in portal.

  2. Kies uw functie-app en druk op Enter. De functie-app wordt geopend in de Azure-portal.

  3. Selecteer op het tabblad Overzicht de benoemde koppeling naast Resourcegroep.

    Selecteer op de pagina Functie-app de resourcegroep die u wilt verwijderen.

  4. Bekijk op de pagina Resourcegroep de lijst met opgenomen resources en controleer of dit de resources zijn die u wilt verwijderen.

  5. Selecteer Resourcegroep verwijderen en volg de instructies.

    Verwijderen kan enkele minuten duren. Wanneer dit is voltooid, verschijnt een aantal seconden een melding in beeld. U kunt ook het belpictogram boven aan de pagina selecteren om de melding te bekijken.

Zie Kosten voor verbruiksplannen inschatten voor meer informatie over de kosten voor Functions.

Volgende stappen

U hebt een functie-app met een eenvoudige HTTP-geactiveerde functie gemaakt in Visual Studio Code. In het volgende artikel vouwt u die functie uit door een uitvoer toe te voegen Bindend. Met deze binding wordt de tekenreeks van de HTTP-aanvraag naar een bericht in een Azure Queue Storage-wachtrij geschreven.

Verbinding maken met een Azure Storage-wachtrij