Snabb start: skapa din första funktion i Azure med Visual StudioQuickstart: Create your first function in Azure using Visual Studio

I den här artikeln använder du Visual Studio för att skapa en C#-baserad funktion i C#-klassen som svarar på HTTP-begäranden.In this article, you use Visual Studio to create a C# class library-based function that responds to HTTP requests. När du har testat koden lokalt distribuerar du den till den serverbaserade miljön för Azure Functions.After testing the code locally, you deploy it to the serverless environment of Azure Functions.

Att slutföra den här snabb starten innebär en låg kostnad av några USD cent eller mindre i ditt Azure-konto.Completing this quickstart incurs a small cost of a few USD cents or less in your Azure account.

FörutsättningarPrerequisites

För att slutföra den här kursen måste du först installera Visual Studio 2019.To complete this tutorial, first install Visual Studio 2019. Se till att du väljer arbets belastningen Azure Development under installationen.Ensure you select the Azure development workload during installation. Om du vill skapa ett Azure Functions-projekt med hjälp av Visual Studio 2017 i stället måste du först installera de senaste Azure Functions verktygen.If you want to create an Azure Functions project by using Visual Studio 2017 instead, you must first install the latest Azure Functions tools.

Installera Visual Studio med arbets belastningen Azure Development

Om du inte har en Azure-prenumerationkan du skapa ett kostnads fritt konto innan du börjar.If you don't have an Azure subscription, create a free account before you begin.

Skapa ett funktionsapprojektCreate a function app project

Azure Functions projekt mal len i Visual Studio skapar ett projekt som du kan publicera till en Function-app i Azure.The Azure Functions project template in Visual Studio creates a project that you can publish to a function app in Azure. Du kan använda en Function-app för att gruppera funktioner som en logisk enhet för enklare hantering, distribution, skalning och delning av resurser.You can use a function app to group functions as a logical unit for easier management, deployment, scaling, and sharing of resources.

  1. Från Visual Studio-menyn väljer du fil > nytt > projekt.From the Visual Studio menu, select File > New > Project.

  2. I skapa ett nytt projekt, ange funktioner i sökrutan, Välj mallen Azure Functions och välj sedan Nästa.In Create a new project, enter functions in the search box, choose the Azure Functions template, and then select Next.

  3. I Konfigurera ditt nya projekt anger du ett projekt namn för projektet och väljer sedan skapa.In Configure your new project, enter a Project name for your project, and then select Create. Funktionsappens namn måste vara ett giltigt C#-namnområde. Du kan inte använda understreck, bindestreck eller andra icke-alfanumeriska tecken.The function app name must be valid as a C# namespace, so don't use underscores, hyphens, or any other nonalphanumeric characters.

  4. Använd värdena i följande tabell för program inställningarna skapa en ny Azure Functions :For the Create a new Azure Functions application settings, use the values in the following table:

    InställningSetting VärdeValue BeskrivningDescription
    Functions-körningFunctions runtime Azure Functions v3
    (.net Core)
    Azure Functions v3
    (.NET Core)
    Det här värdet skapar ett funktions projekt som använder version 3. x-körningen av Azure Functions, som stöder .NET Core 3. x.This value creates a function project that uses the version 3.x runtime of Azure Functions, which supports .NET Core 3.x. Azure Functions 1.x har stöd för .NET Framework.Azure Functions 1.x supports the .NET Framework. Mer information finns i Översikt över Azure Functions körnings versioner.For more information, see Azure Functions runtime versions overview.
    Funktions mal lenFunction template HTTP-utlösareHTTP trigger Det här värdet skapar en funktion som utlöses av en HTTP-begäran.This value creates a function triggered by an HTTP request.
    Lagrings konto (AzureWebJobsStorage)Storage account (AzureWebJobsStorage) Storage-emulatorStorage emulator Eftersom en Azure-funktion kräver ett lagrings konto, tilldelas eller skapas en när du publicerar projektet till Azure.Because an Azure Function requires a storage account, one is assigned or created when you publish your project to Azure. En HTTP-utlösare använder inte en anslutnings sträng för Azure Storage konto. alla andra utlösare kräver en giltig anslutnings sträng för Azure Storage konto.An HTTP trigger doesn't use an Azure Storage account connection string; all other trigger types require a valid Azure Storage account connection string.
    AuktoriseringsnivåAuthorization level AntalAnonymous Funktionen som skapats kan utlösas av alla klienter utan att en nyckel anges.The created function can be triggered by any client without providing a key. Den här auktoriseringsinställningen gör det enkelt att testa den nya funktionen.This authorization setting makes it easy to test your new function. Mer information om nycklar och auktorisering finns i auktoriseringsarkiv och http-och webhook-bindningar.For more information about keys and authorization, see Authorization keys and HTTP and webhook bindings.

    Azure Functions projekt inställningar

    Se till att du anger en Anonym åtkomst nivå .Make sure you set the Authorization level to Anonymous. Om du väljer standard funktions nivån måste du presentera funktions nyckeln i begär Anden för att få åtkomst till funktions slut punkten.If you choose the default level of Function, you're required to present the function key in requests to access your function endpoint.

  5. Välj skapa för att skapa funktionen Project och funktionen http-utlösare.Select Create to create the function project and HTTP trigger function.

Visual Studio skapar ett projekt och en klass som innehåller en exempel kod för funktionen HTTP-utlösare.Visual Studio creates a project and class that contains boilerplate code for the HTTP trigger function type. Den formaterade exempelkoden skickar ett HTTP-svar som innehåller ett värde från förfrågan eller frågesträngen.The boilerplate code sends an HTTP response that includes a value from the request body or query string. HttpTriggerAttributet anger att funktionen utlöses av en HTTP-begäran.The HttpTrigger attribute specifies that the function is triggered by an HTTP request.

Byt namn på funktionenRename the function

FunctionNameAttributet Method anger namnet på funktionen, som som standard genereras som Function1 .The FunctionName method attribute sets the name of the function, which by default is generated as Function1. Eftersom verktyget inte tillåter att du åsidosätter standard funktions namnet när du skapar projektet ska du ta en minut för att skapa ett bättre namn för funktions klassen, filen och metadata.Since the tooling doesn't let you override the default function name when you create your project, take a minute to create a better name for the function class, file, and metadata.

  1. I Utforskaren högerklickar du på filen Function1. CS och byter namn på den till HttpExample.cs .In File Explorer, right-click the Function1.cs file and rename it to HttpExample.cs.

  2. I koden byter du namn på Function1-klassen till ' HttpExample '.In the code, rename the Function1 class to `HttpExample'.

  3. I HttpTrigger metoden med namnet Run byter du namn på FunctionName attributet Method till HttpExample .In the HttpTrigger method named Run, rename the FunctionName method attribute to HttpExample.

Nu när du har bytt namn på funktionen kan du testa den på den lokala datorn.Now that you've renamed the function, you can test it on your local computer.

Köra funktionen lokaltRun the function locally

Visual Studio integreras med Azure Functions Core Tools så att du kan testa dina funktioner lokalt med den fullständiga Azure Functions-körningen.Visual Studio integrates with Azure Functions Core Tools so that you can test your functions locally using the full Azure Functions runtime.

  1. Tryck på F5 i Visual Studio för att köra funktionen.To run your function, press F5 in Visual Studio. Du kan behöva aktivera ett brand Väggs undantag så att verktygen kan hantera HTTP-förfrågningar.You might need to enable a firewall exception so that the tools can handle HTTP requests. Tillstånds nivåer tillämpas aldrig när du kör en funktion lokalt.Authorization levels are never enforced when you run a function locally.

  2. Kopiera URL:en för funktionen från dina Azure Functions-utdata.Copy the URL of your function from the Azure Functions runtime output.

    Lokal Azure-körningsmiljö

  3. Klistra in webbadressen för HTTP-begäran i webbläsarens adressfält.Paste the URL for the HTTP request into your browser's address bar. Lägg till frågesträngen ?name=<YOUR_NAME> till denna URL och kör begäran.Append the query string ?name=<YOUR_NAME> to this URL and run the request. Följande bild visar svaret i webbläsaren till den lokala GET-begäran som returnerades av funktionen:The following image shows the response in the browser to the local GET request returned by the function:

    Svar för funktion-localhost i webbläsaren

  4. Stoppa fel sökningen genom att trycka på SKIFT + F5 i Visual Studio.To stop debugging, press Shift+F5 in Visual Studio.

När du har kontrollerat att funktionen körs korrekt på den lokala datorn är det dags att publicera projektet på Azure.After you've verified that the function runs correctly on your local computer, it's time to publish the project to Azure.

Publicera projektet på AzurePublish the project to Azure

Innan du kan publicera ditt projekt måste du ha en Function-app i din Azure-prenumeration.Before you can publish your project, you must have a function app in your Azure subscription. Visual Studio-publicering skapar en Function-app för första gången du publicerar projektet.Visual Studio publishing creates a function app for you the first time you publish your project.

  1. I Solution Explorer högerklickar du på projektet och väljer publicera och i mål väljer du Azure och sedan Nästa.In Solution Explorer, right-click the project and select Publish and in Target, select Azure then Next.

  2. För det specifika målet väljer du Azure Funktionsapp (Windows), som skapar en Function-app som körs i Windows.For the Specific target, choose Azure Function App (Windows), which creates a function app that runs on Windows.

  3. I funktions instans väljer du skapa en ny Azure-funktion...In Function Instance, choose Create a new Azure Function...

    Skapa en ny function-serverinstans

  4. Skapa en ny instans med de värden som anges i följande tabell:Create a new instance using the values specified in the following table:

    InställningSetting VärdeValue BeskrivningDescription
    NamnName Globalt unikt namnGlobally unique name Namn som unikt identifierar din nya funktionsapp.Name that uniquely identifies your new function app. Acceptera det här namnet eller ange ett nytt namn.Accept this name or enter a new name. Giltiga tecken är: a-z , 0-9 , och - .Valid characters are: a-z, 0-9, and -.
    PrenumerationSubscription Din prenumerationYour subscription Den Azure-prenumeration som ska användas.The Azure subscription to use. Godkänn denna prenumeration eller Välj en ny i list rutan.Accept this subscription or select a new one from the drop-down list.
    Resurs gruppResource group Namnet på din resurs gruppName of your resource group Resurs gruppen där du vill skapa din Function-app.The resource group in which to create your function app. Välj en befintlig resurs grupp i den nedrullningsbara listan eller Välj ny för att skapa en ny resurs grupp.Select an existing resource group from the drop-down list or choose New to create a new resource group.
    Typ av planPlan Type FörbrukningConsumption När du publicerar projektet till en Function-app som körs i en förbruknings planbetalar du bara för körningar av Functions-appen.When you publish your project to a function app that runs in a Consumption plan, you pay only for executions of your functions app. Andra värd planer ådrar sig högre kostnader.Other hosting plans incur higher costs.
    PlatsLocation Platsen för App ServiceLocation of the app service Välj en plats i en region nära dig eller andra tjänster som dina funktioner har åtkomst till.Choose a Location in a region near you or other services your functions access.
    Azure StorageAzure Storage Allmänt lagrings kontoGeneral-purpose storage account Ett Azure Storage-konto krävs av Functions-körningen.An Azure Storage account is required by the Functions runtime. Välj nytt om du vill konfigurera ett allmänt lagrings konto.Select New to configure a general-purpose storage account. Du kan också välja ett befintligt konto som uppfyller kraven för lagrings kontot.You can also choose an existing account that meets the storage account requirements.

    Dialogrutan Skapa App Service

  5. Välj skapa för att skapa en Function-app och dess relaterade resurser i Azure.Select Create to create a function app and its related resources in Azure. Status för att skapa resurser visas längst ned till vänster i fönstret.Status of resource creation is shown in the lower left of the window.

  6. Tillbaka i Functions-instansen, kontrol lera att Kör från paket filen är markerat.Back in Functions instance, make sure that Run from package file is checked. Din Function-app distribueras med hjälp av zip Deploy med läget Kör-från-Package aktiverat.Your function app is deployed using Zip Deploy with Run-From-Package mode enabled. Detta är den rekommenderade distributions metoden för ditt Functions-projekt, eftersom den resulterar i bättre prestanda.This is the recommended deployment method for your functions project, since it results in better performance.

    Slutför skapande av profil

  7. Välj Slutför och på sidan publicera väljer du publicera för att distribuera paketet som innehåller dina projektfiler till din nya Function-app i Azure.Select Finish, and on the Publish page, select Publish to deploy the package containing your project files to your new function app in Azure.

    När distributionen är klar visas rot-URL: en för Function-appen i Azure på fliken publicera .After the deployment completes the root URL of the function app in Azure is shown in the Publish tab.

  8. På fliken publicera väljer du Hantera i Cloud Explorer.In the Publish tab, choose Manage in Cloud Explorer. Då öppnas Azure-resursen ny function-app i Cloud Explorer.This opens the new function app Azure resource in Cloud Explorer.

    Meddelande som anger att publiceringen lyckades

    Med Cloud Explorer kan du använda Visual Studio för att visa innehållet på platsen, starta och stoppa-appen och bläddra direkt för att söka efter app-resurser i Azure och i Azure Portal.Cloud Explorer lets you use Visual Studio to view the contents of the site, start and stop the function app, and browse directly to function app resources on Azure and in the Azure portal.

Testa din funktion i AzureTest your function in Azure

  1. I Cloud Explorer ska din nya Function-app väljas.In Cloud Explorer, your new function app should be selected. Om inte, expanderar du prenumerationen > app Services och väljer sedan den nya Function-appen.If not, expand your subscription > App Services, and select your new function app.

  2. Högerklicka på Function-appen och välj Öppna i webbläsare.Right-click the function app and choose Open in Browser. Detta öppnar roten för din Function-app i din standard webbläsare och visar sidan som visar att funktions programmet körs.This opens the root of your function app in your default web browser and displays the page that indicates your function app is running.

    Function-appen körs

  3. I adress fältet i webbläsaren lägger du till strängen i /api/HttpExample?name=Functions bas-URL: en och kör begäran.In the address bar in the browser, append the string /api/HttpExample?name=Functions to the base URL and run the request.

    Den URL som anropar funktionen HTTP-utlösare har följande format:The URL that calls your HTTP trigger function is in the following format:

    http://<APP_NAME>.azurewebsites.net/api/HttpExample?name=Functions

  4. Gå till denna URL så ser du ett svar i webbläsaren till den fjärranslutna GET-begäran som returnerades av funktionen, som ser ut som i följande exempel:Go to this URL and you see a response in the browser to the remote GET request returned by the function, which looks like the following example:

    Funktionssvar i webbläsaren

Rensa resurserClean up resources

De andra snabbstarterna i den här samlingen bygger på den här snabbstarten.Other quickstarts in this collection build upon this quickstart. Om du planerar att arbeta med efterföljande snabb starter, självstudier eller med någon av de tjänster som du har skapat i den här snabb starten ska du inte rensa resurserna.If you plan to work with subsequent quickstarts, tutorials, or with any of the services you have created in this quickstart, do not clean up the resources.

Resurser i Azure avser funktionsappar, funktioner, lagringskonton och så vidare.Resources in Azure refer to function apps, functions, storage accounts, and so forth. De är grupperade i resurs grupper och du kan ta bort allt i en grupp genom att ta bort gruppen.They're grouped into resource groups, and you can delete everything in a group by deleting the group.

Du skapade resurser för att slutföra de här snabbstarterna.You created resources to complete these quickstarts. Det är möjligt att du debiteras för de här resurserna beroende på din kontostatus och dina servicepriser.You may be billed for these resources, depending on your account status and service pricing. Om du inte behöver resurserna längre så visar vi hur du tar bort dem här:If you don't need the resources anymore, here's how to delete them:

  1. I Cloud Explorer expanderar du prenumerationen > app Services, högerklickar på din Function-app och väljer Öppna i portalen.In the Cloud Explorer, expand your subscription > App Services, right-click your function app, and choose Open in Portal.

  2. På sidan Function-app väljer du fliken Översikt och väljer sedan länken under resurs grupp.In the function app page, select the Overview tab and then select the link under Resource group.

    Välj den resurs grupp som ska tas bort från sidan funktions program

  3. På sidan resurs grupp granskar du listan över resurser som ingår och kontrollerar att de är de som du vill ta bort.In the Resource group page, review the list of included resources, and verify that they're the ones you want to delete.

  4. Välj Ta bort resursgrupp och följ instruktionerna.Select Delete resource group, and follow the instructions.

    Borttagningen kan ta några minuter.Deletion may take a couple of minutes. När du är färdig visas ett meddelande i några sekunder.When it's done, a notification appears for a few seconds. Du kan även välja klockikonen längst upp på sidan för att se meddelandet.You can also select the bell icon at the top of the page to view the notification.

Nästa stegNext steps

I den här snabb starten använde du Visual Studio för att skapa och publicera en C# Function-app i Azure med en enkel HTTP-utlösnings funktion.In this quickstart, you used Visual Studio to create and publish a C# function app in Azure with a simple HTTP trigger function.

Gå vidare till nästa artikel om du vill lära dig hur du lägger till en Azure Storage Queue-bindning till din funktion:Advance to the next article to learn how to add an Azure Storage queue binding to your function: