Az első függvény létrehozása a Visual Studio használatávalCreate your first function using Visual Studio

Az Azure Functions lehetővé teszi a kód kiszolgáló nélküli környezetben történő végrehajtását anélkül, hogy először létre kellene hoznia egy virtuális gépet, vagy közzé kellene tennie egy webalkalmazást.Azure Functions lets you execute your code in a serverless environment without having to first create a VM or publish a web application.

Ebből a cikkből megtudhatja, hogyan használható a Visual Studio 2019 a "Hello World" függvény helyi létrehozásához és teszteléséhez, majd az Azure-ba való közzétételéhez.In this article, you learn how to use Visual Studio 2019 to locally create and test a "hello world" function and then publish it to Azure. Ez a rövid útmutató a Visual Studio 2019-hez készült.This quickstart is designed for Visual Studio 2019. Ha functions-projektet hoz létre a Visual Studio 2017 használatával, először telepítenie kell a legújabb Azure functions eszközöket.When creating a Functions project using Visual Studio 2017, you must first install the latest Azure Functions tools.

A függvény által visszaadott localhost válasz a böngészőben

ElőfeltételekPrerequisites

Az oktatóanyag elvégzéséhez először telepítenie kell a Visual Studio 2019alkalmazást.To complete this tutorial, you must first install Visual Studio 2019. Győződjön meg arról, hogy az Azure-fejlesztési munkaterhelés is telepítve van.Make sure that the Azure development workload is also installed.

A Visual Studio telepítése az Azure-fejlesztési számítási feladattal

Ha nem rendelkezik Azure-előfizetéssel, a Kezdés előtt hozzon létre egy ingyenes fiókot .If you don't have an Azure subscription, create a free account before you begin.

Függvényalkalmazás-projekt létrehozásaCreate a function app project

A Visual Studio Azure Functions projektsablonja egy olyan projektet hoz létre, amely közzétehető egy Azure-függvényalkalmazásban.The Azure Functions project template in Visual Studio creates a project that can be published to a function app in Azure. A függvények használatával logikai egységként csoportosíthatja a függvényeket az erőforrások kezeléséhez, üzembe helyezéséhez és megosztásához.You can use a function app to group functions as a logical unit for management, deployment, and sharing of resources.

  1. A Visual Studióban a fájl menüben válassza az új > projektlehetőséget.In Visual Studio, on the File menu, select New > Project.

  2. Az új projekt létrehozása párbeszédpanelen keresse meg functionsa elemet, válassza ki a Azure functions sablont, és kattintson a továbbgombra.In the Create a new project dialog box, search for functions, choose the Azure Functions template, and select Next.

  3. Adja meg a projekt nevét, majd válassza a Létrehozáslehetőséget.Enter a name for your project, and select Create. A függvényalkalmazás nevének egy C#-névtérként is érvényesnek kell lennie, ezért ne használjon aláhúzásjeleket, kötőjeleket vagy más nem alfanumerikus karaktereket.The function app name must be valid as a C# namespace, so don't use underscores, hyphens, or any other nonalphanumeric characters.

  4. Az új Azure functions alkalmazás létrehozásaterületen használja az alábbi beállításokat:In Create a new Azure Functions application, use the following options:

    • Azure functions v2 (.net Core) 1Azure Functions v2 (.NET Core) 1
    • HTTP-triggerHTTP trigger
    • Storage-fiók: Storage-emulátorStorage Account: Storage Emulator
    • Engedélyezési szint: NévtelenAuthorization level: Anonymous
    BeállításOption Ajánlott értékSuggested value LeírásDescription
    Függvények futtatókörnyezeteFunctions runtime Azure functions 2. x
    (.net Core)
    Azure Functions 2.x
    (.NET Core)
    Ez a beállítás egy olyan Function projektet hoz létre, amely a .NET Core-t támogató Azure Functions 2. x futtatókörnyezetét használja.This setting creates a function project that uses the version 2.x runtime of Azure Functions, which supports .NET Core. Az Azure Functions 1.x támogatja a .NET-keretrendszert.Azure Functions 1.x supports the .NET Framework. További információ: Target Azure functions Runtime Version.For more information, see Target Azure Functions runtime version.
    Függvény sablonjaFunction template HTTP-triggerHTTP trigger Ez a beállítás egy HTTP-kérelem által aktivált függvényt hoz létre.This setting creates a function triggered by an HTTP request.
    TárfiókStorage Account Storage-emulátorStorage Emulator Egy HTTP-trigger nem használja az Azure Storage-fiókhoz való kapcsolatokat.An HTTP trigger doesn't use the Azure Storage account connection. A többi triggernek érvényes Storage-fiókhoz tartozó kapcsolati sztringre van szüksége.All other trigger types require a valid Storage account connection string. Mivel a functions szolgáltatáshoz Storage-fiók szükséges, az egyiket a rendszer a projekt Azure-ba való közzétételekor rendeli hozzá vagy hozza létre.Because Functions requires a storage account, one is assigned or created when you publish your project to Azure.
    EngedélyszintAuthorization level NévtelenAnonymous A létrehozott függvényt bármely ügyfél elindíthatja, kulcs megadása nélkül.The created function can be triggered by any client without providing a key. Ez az engedélyezési beállítás megkönnyíti az új függvény tesztelését.This authorization setting makes it easy to test your new function. A kulcsokról és az engedélyezésről a HTTP- és webhookkötések című témakör Engedélyezési kulcsok szakaszában talál további információt.For more information about keys and authorization, see Authorization keys in the HTTP and webhook bindings.

    Megjegyzés

    Győződjön meg arról, hogy Anonymousaz engedélyezési szint beállítása a következőre:.Make sure you set the Authorization level to Anonymous. Ha az alapértelmezett szintet Functionválasztja, akkor a függvény-végpont eléréséhez a kérelmekben be kell mutatnia a függvény kulcsát .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álassza a Létrehozás lehetőséget a függvény projekt és a http által aktivált függvény létrehozásához.Select Create to create the function project and HTTP-triggered function.

A Visual Studio létrehoz egy projektet és egy osztályt, amely tartalmazza a HTTP trigger függvény típusának szabványos kódját.Visual Studio creates a project and class that contains boilerplate code for the HTTP trigger function type. A metódus HttpTriggerattribútuma beállítja a függvény nevét, amely alapértelmezés szerint a. FunctionNameThe FunctionName attribute on the method sets the name of the function, which by default is HttpTrigger. Az HttpTrigger attribútum azt adja meg, hogy a függvényt egy HTTP-kérelem indítja el.The HttpTrigger attribute specifies that the function is triggered by an HTTP request. A sablonkód elküld egy HTTP-választ, amely tartalmaz egy értéket a kérelem szövegtörzséből vagy a lekérdezési sztringből.The boilerplate code sends an HTTP response that includes a value from the request body or query string.

A függvény képességeit a bemeneti és kimeneti kötésekkel bővítheti, ha a megfelelő attribútumokat alkalmazza a metódusra.You can expand the capabilities of your function using input and output bindings by applying the appropriate attributes to the method. További információkért lásd az Azure Functions C#-fejlesztői referenciaanyagának Eseményindítók és kötések szakaszát.For more information, see the Triggers and bindings section of the Azure Functions C# developer reference.

Most, hogy már létrehozott egy függvényprojektet és egy HTTP-eseményindítóval aktivált függvényt, tesztelheti a helyi számítógépen.Now that you've created your function project and an HTTP-triggered function, you can test it on your local computer.

Függvény helyi futtatásaRun the function locally

A Visual Studio integrálva van Azure Functions Core Tools, így a függvények a teljes functions futtatókörnyezet használatával helyileg is tesztelhető.Visual Studio integrates with Azure Functions Core Tools so that you can test your functions locally using the full Functions runtime.

  1. A függvény futtatásához nyomja le az F5billentyűt.To run your function, press F5. Előfordulhat, hogy engedélyeznie kell egy tűzfal-kivételt, hogy az eszközök kezelni tudják a HTTP-kérelmeket.You may need to enable a firewall exception so that the tools can handle HTTP requests. A helyi futtatáskor a rendszer soha nem kényszeríti ki az engedélyezési szinteket.Authorization levels are never enforced when running locally.

  2. Másolja a függvény URL-címét az Azure-függvény futtatókörnyezetéből.Copy the URL of your function from the Azure Functions runtime output.

    Az Azure helyi futtatókörnyezete

  3. Illessze be a HTTP-kérelem URL-címét a böngésző címsorába.Paste the URL for the HTTP request into your browser's address bar. Az URL-címhez fűzze hozzá a ?name=<YOUR_NAME> lekérdezési sztringet, és hajtsa végre a kérelmet.Append the query string ?name=<YOUR_NAME> to this URL and execute the request. Az alábbiakban látható a böngészőben a helyi GET kérelemre a függvény által visszaadott válasz:The following shows the response in the browser to the local GET request returned by the function:

    A függvény által visszaadott localhost válasz a böngészőben

  4. A hibakeresés leállításához nyomja le a Shift + F5 billentyűkombinációt.To stop debugging, press Shift + F5.

Miután ellenőrizte, hogy a függvény megfelelően fut a helyi számítógépen, tegye közzé a projektet az Azure-ban.After you have verified that the function runs correctly on your local computer, it's time to publish the project to Azure.

A projekt közzététele az Azure-banPublish the project to Azure

A projekt közzétételéhez rendelkeznie kell egy függvényalkalmazással.az Azure-előfizetéséhez.You must have a function app in your Azure subscription before you can publish your project. A Visual Studio Publishing létrehoz egy Function alkalmazást a projekt első közzétételekor.Visual Studio publishing creates a function app for you the first time you publish your project.

  1. A Megoldáskezelőben kattintson a jobb gombbal a projektre, és válassza a Publish (Közzététel) lehetőséget.In Solution Explorer, right-click the project and select Publish.

  2. A Közzététel célhelyének kiválasztása párbeszédpanelen a rendszerkép alatti táblázatban megadott közzétételi beállításokat használhatja:In the Pick a publish target dialog, use the publish options as specified in the table below the image:

    Közzétételi cél kiválasztása

    BeállításOption LeírásDescription
    Azure Functions használati tervAzure Functions Consumption plan Ha a projektet egy felhasználásicsomagban futó Function alkalmazásban teszi közzé, csak a functions-alkalmazás végrehajtása után kell fizetnie.When you publish your project to a function app that runs in a Consumption plan, you only pay for executions of your functions app. Más üzemeltetési csomagok magasabb költségekkel járnak.Other hosting plans incur higher costs. További információ: Azure functions skálázás és üzemeltetés.To learn more, see Azure Functions scale and hosting.
    Új létrehozásaCreate new A kapcsolódó erőforrásokkal rendelkező új Function-alkalmazás az Azure-ban jön létre.A new function app, with related resources, is created in Azure. Ha a Meglévő kiválasztása elemet választja, az Azure-beli meglévő függvényalkalmazás összes fájlját felülírják a helyi projekt fájljai.When you choose Select Existing, all files in the existing function app in Azure are overwritten by files from the local project. Csak akkor használja ezt a lehetőséget, ha frissítéseket tesz újra közzé egy meglévő függvényalkalmazásba.Only use this option when republishing updates to an existing function app.
    Futtatás a csomagfájl alapjánRun from package file A Function alkalmazás üzembe helyezése a zip - telepítéssel, a csomaghoz való futtatási móddal engedélyezve.Your function app is deployed using Zip Deploy with Run-From-Package mode enabled. A függvények futtatásának ajánlott módja, ami jobb teljesítményt eredményez.This is the recommended way of running your functions, which results in better performance. Ha nem használja ezt a lehetőséget, ügyeljen arra, hogy a Function app-projekt helyileg fusson, mielőtt közzéteszi az Azure-ban.When not using this option, make sure to stop your function app project from running locally before you publish to Azure.
  3. Kattintson a Publish (Közzététel) elemre.Select Publish. Ha még nem jelentkezett be Azure-fiókjába a Visual studióból, válassza a Bejelentkezéslehetőséget.If you haven't already signed-in to your Azure account from Visual Studio, select Sign-in. Létrehozhat egy ingyenes Azure-fiókot is.You can also create a free Azure account.

  4. A app Serviceban: Hozzon létre új párbeszédpanelt, és használja az alábbi táblázatban megadott üzemeltetési beállításokat a rendszerkép alatt:In the App Service: Create new dialog, use the Hosting settings as specified in the table below the image:

    A Create App Service (App Service létrehozása) párbeszédpanel

    BeállításSetting Ajánlott értékSuggested value LeírásDescription
    NameName Globálisan egyedi névGlobally unique name Az új függvényalkalmazást azonosító egyedi név.Name that uniquely identifies your new function app. Érvényes karakterek: a-z, 0-9 és -.Valid characters are a-z, 0-9, and -.
    ElőfizetésSubscription Válassza ki az előfizetésétChoose your subscription A használandó előfizetés.The Azure subscription to use.
    ErőforráscsoportResource Group myResourceGroupmyResourceGroup Az erőforráscsoport neve, amelyben létrehozza a függvényalkalmazást.Name of the resource group in which to create your function app. Válassza az Új elemet egy új erőforráscsoport létrehozásához.Choose New to create a new resource group.
    Üzemeltetési csomagHosting Plan Használatalapú csomagConsumption plan Az új elemre kattintva hozzon létre egy kiszolgáló nélküli tervet, és válassza a méret alatti felhasználás lehetőséget.Make sure to choose the Consumption under Size after you select New to create a serverless plan. Ezenkívül válasszon ki egy Helyet egy, a közelben, vagy a függvények által elért más szolgáltatások közelében található régióban.Also, choose a Location in a region near you or near other services your functions access. Ha nem használatalapú csomagot használ, foglalkoznia kell a függvényalkalmazás méretezésével.When you run in a plan other than Consumption, you must manage the scaling of your function app.
    Azure StorageAzure Storage Általános célú Storage-fiókGeneral-purpose storage account A Functions futtatókörnyezetének szüksége van egy Azure Storage-fiókra.An Azure storage account is required by the Functions runtime. Az új gombra kattintva hozzon létre egy általános célú Storage-fiókot.Select New to create a general-purpose storage account. Meglévő fiókot is használhat, amennyiben az megfelel a tárfiókokra vonatkozó követelményeknek.You can also use an existing account that meets the storage account requirements.
  5. A Létrehozás gombra kattintva létrehozhat egy Function alkalmazást és kapcsolódó erőforrásokat az Azure-ban ezekkel a beállításokkal, és üzembe helyezheti a függvény projekt kódját.Select Create to create a function app and related resources in Azure with these settings and deploy your function project code.

  6. Miután az üzembe helyezés befejeződött, jegyezze fel a webhely URL-címét, amely a függvényalkalmazás címe az Azure-ban.After the deployment is complete, make a note of the Site URL value, which is the address of your function app in Azure.

    Sikeres közzétételt jelző üzenet

A függvény tesztelése az Azure-banTest your function in Azure

  1. Másolja a függvényalkalmazás alap URL-címét a Publish (Közzététel) profiloldalról.Copy the base URL of the function app from the Publish profile page. Cserélje ki a függvény helyi tesztelésekor használt localhost:port URL-címrészt az új alap URL-címmel.Replace the localhost:port portion of the URL you used when testing the function locally with the new base URL. Ahogyan korábban, most is az URL-címhez fűzze hozzá a ?name=<YOUR_NAME> lekérdezési sztringet, és hajtsa végre a kérelmet.As before, make sure to append the query string ?name=<YOUR_NAME> to this URL and execute the request.

    A HTTP-eseményindítót használó függvényt meghívó URL-címnek az alábbi formátumban kell lennie:The URL that calls your HTTP triggered function should be in the following format:

     http://<APP_NAME>.azurewebsites.net/api/<FUNCTION_NAME>?name=<YOUR_NAME> 
    
  2. Illessze be a HTTP-kérelem új URL-címét a böngésző címsorába.Paste this new URL for the HTTP request into your browser's address bar. Az alábbiakban látható a böngészőben a távoli GET kérelemre a függvény által visszaadott válasz:The following shows the response in the browser to the remote GET request returned by the function:

    A függvény által visszaadott válasz a böngészőben

További lépésekNext steps

A Visual Studióval egy egyszerű HTTP-triggerrel C# aktivált függvény használatával hozhat létre és tehet közzé egy Function-alkalmazást az Azure-ban.You have used Visual Studio to create and publish a C# function app in Azure with a simple HTTP triggered function. Ha többet szeretne megtudni a függvények .NET-es kódtáraként való fejlesztéséről, tekintse meg a C# Azure functions fejlesztői referenciát.To learn more about developing functions as .NET class libraries, see Azure Functions C# developer reference.