Szybki Start: Tworzenie funkcji języka C# na platformie Azure przy użyciu Visual Studio CodeQuickstart: Create a C# function in Azure using Visual Studio Code

W tym artykule użyto Visual Studio Code do utworzenia funkcji opartej na bibliotece języka C#, która reaguje na żądania HTTP.In this article, you use Visual Studio Code to create a C# class library-based function that responds to HTTP requests. Po przetestowaniu kodu lokalnie należy wdrożyć go w środowisku bezserwerowym Azure Functions.After testing the code locally, you deploy it to the serverless environment of Azure Functions.

W ramach tego przewodnika Szybki Start powiąże się niewielką opłatą za kilka centów USD lub mniej na koncie platformy Azure.Completing this quickstart incurs a small cost of a few USD cents or less in your Azure account.

Istnieje również wersja tego artykułu oparta na interfejsie wiersza polecenia .There's also a CLI-based version of this article.

Konfigurowanie środowiskaConfigure your environment

Przed rozpoczęciem upewnij się, że zostały spełnione następujące wymagania:Before you get started, make sure you have the following requirements in place:

Utwórz projekt lokalnyCreate your local project

W tej sekcji użyjesz Visual Studio Code, aby utworzyć projekt Azure Functions lokalnych w języku C#.In this section, you use Visual Studio Code to create a local Azure Functions project in C#. W dalszej części tego artykułu opublikujesz kod funkcji na platformie Azure.Later in this article, you'll publish your function code to Azure.

  1. Wybierz ikonę platformy Azure na pasku działania, a następnie w obszarze Azure: Functions wybierz ikonę Utwórz nowy projekt... .Choose the Azure icon in the Activity bar, then in the Azure: Functions area, select the Create new project... icon.

    Wybierz pozycję Utwórz nowy projekt

  2. Wybierz lokalizację katalogu dla obszaru roboczego projektu, a następnie wybierz pozycję Wybierz.Choose a directory location for your project workspace and choose Select.

    Uwaga

    Te kroki zostały zaprojektowane do ukończenia poza obszarem roboczym.These steps were designed to be completed outside of a workspace. W takim przypadku nie wybieraj folderu projektu, który jest częścią obszaru roboczego.In this case, do not select a project folder that is part of a workspace.

  3. Podaj następujące informacje na ekranie:Provide the following information at the prompts:

    • Wybierz język projektu funkcji : Wybierz C# .Select a language for your function project : Choose C#.

    • Wybierz szablon dla pierwszej funkcji projektu : Wybierz HTTP trigger .Select a template for your project's first function : Choose HTTP trigger.

    • Podaj nazwę funkcji : type HttpExample .Provide a function name : Type HttpExample.

    • Podaj przestrzeń nazw : type My.Functions .Provide a namespace : Type My.Functions.

    • Poziom autoryzacji : Wybierz Anonymous , co umożliwi wszystkim wywoływanie punktu końcowego funkcji.Authorization level : Choose Anonymous, which enables anyone to call your function endpoint. Aby dowiedzieć się więcej o poziomie autoryzacji, zobacz klucze autoryzacji.To learn about authorization level, see Authorization keys.

    • Wybierz, w jaki sposób chcesz otworzyć projekt : Wybierz Add to workspace .Select how you would like to open your project : Choose Add to workspace.

  4. Korzystając z tych informacji, Visual Studio Code generuje projekt Azure Functions z wyzwalaczem HTTP.Using this information, Visual Studio Code generates an Azure Functions project with an HTTP trigger. Pliki projektu lokalnego można wyświetlić w Eksploratorze.You can view the local project files in the Explorer. Aby dowiedzieć się więcej na temat tworzonych plików, zobacz pliki wygenerowanego projektu.To learn more about files that are created, see Generated project files.

Lokalne uruchamianie funkcjiRun the function locally

Visual Studio Code integruje się z narzędziami Azure Functions Core , aby umożliwić uruchomienie tego projektu na lokalnym komputerze deweloperskim przed opublikowaniem na platformie Azure.Visual Studio Code integrates with Azure Functions Core tools to let you run this project on your local development computer before you publish to Azure.

  1. Aby wywołać funkcję, naciśnij klawisz F5 , aby uruchomić projekt aplikacji funkcji.To call your function, press F5 to start the function app project. Dane wyjściowe z pakietu Core Tools są wyświetlane na panelu terminalu.Output from Core Tools is displayed in the Terminal panel.

  2. Jeśli nie zainstalowano jeszcze Azure Functions Core Tools, wybierz opcję Zainstaluj w wierszu polecenia.If you haven't already installed Azure Functions Core Tools, select Install at the prompt. Po zainstalowaniu podstawowych narzędzi aplikacja zostanie uruchomiona na panelu terminalu .When the Core Tools are installed, your app starts in the Terminal panel. Można zobaczyć punkt końcowy adresu URL funkcji wyzwalanej przez protokół HTTP, działającej lokalnie.You can see the URL endpoint of your HTTP-triggered function running locally.

    Funkcja lokalna VS Code danych wyjściowych

  3. Po uruchomieniu podstawowych narzędzi przejdź do następującego adresu URL, aby wykonać żądanie GET, które zawiera ?name=Functions ciąg zapytania.With Core Tools running, navigate to the following URL to execute a GET request, which includes ?name=Functions query string.

    http://localhost:7071/api/HttpExample?name=Functions

  4. Zostanie zwrócona odpowiedź, która wygląda podobnie do następującej w przeglądarce:A response is returned, which looks like the following in a browser:

    Przeglądarka — przykładowe dane wyjściowe hosta lokalnego

  5. Informacje o żądaniu są wyświetlane w panelu terminalu .Information about the request is shown in Terminal panel.

    Rozpoczęcie VS Code hosta zadań — dane wyjściowe terminalu

  6. Naciśnij klawisze CTRL + C , aby zatrzymać podstawowe narzędzia i rozłączyć debuger.Press Ctrl + C to stop Core Tools and disconnect the debugger.

Po sprawdzeniu, że funkcja działa poprawnie na komputerze lokalnym, można użyć Visual Studio Code do opublikowania projektu bezpośrednio na platformie Azure.After you've verified that the function runs correctly on your local computer, it's time to use Visual Studio Code to publish the project directly to Azure.

Logowanie się do platformy AzureSign in to Azure

Zanim będzie można opublikować aplikację, należy zalogować się do platformy Azure.Before you can publish your app, you must sign in to Azure.

  1. Jeśli jeszcze nie zalogowano się, wybierz ikonę platformy Azure na pasku działania, a następnie w obszarze Azure: Functions wybierz pozycję Zaloguj się do platformy Azure.... Jeśli jeszcze tego nie masz, możesz utworzyć bezpłatne konto platformy Azure.If you aren't already signed in, choose the Azure icon in the Activity bar, then in the Azure: Functions area, choose Sign in to Azure.... If you don't already have one, you can Create a free Azure account. Studenci mogą utworzyć bezpłatne konto platformy Azure dla studentów.Students can create a free Azure account for Students.

    Zaloguj się do platformy Azure w ramach VS Code

    Jeśli użytkownik jest już zalogowany, przejdź do następnej sekcji.If you're already signed in, go to the next section.

  2. Po wyświetleniu monitu w przeglądarce wybierz swoje konto platformy Azure i zaloguj się przy użyciu poświadczeń konta platformy Azure.When prompted in the browser, choose your Azure account and sign in using your Azure account credentials.

  3. Po pomyślnym zalogowaniu można zamknąć nowe okno przeglądarki.After you've successfully signed in, you can close the new browser window. Subskrypcje należące do Twojego konta platformy Azure są wyświetlane na pasku bocznym.The subscriptions that belong to your Azure account are displayed in the Side bar.

Publikowanie projektu na platformie AzurePublish the project to Azure

W tej sekcji utworzysz aplikację funkcji i powiązane zasoby w ramach subskrypcji platformy Azure, a następnie wdrożono swój kod.In this section, you create a function app and related resources in your Azure subscription and then deploy your code.

Ważne

Publikowanie do istniejącej aplikacji funkcji spowoduje zastąpienie zawartości tej aplikacji na platformie Azure.Publishing to an existing function app overwrites the content of that app in Azure.

  1. Wybierz ikonę platformy Azure na pasku działania, a następnie w obszarze Azure: Functions wybierz przycisk Wdróż do aplikacji funkcji... .Choose the Azure icon in the Activity bar, then in the Azure: Functions area, choose the Deploy to function app... button.

    Publikowanie projektu na platformie Azure

  2. Podaj następujące informacje na ekranie:Provide the following information at the prompts:

    • Wybierz folder: Wybierz folder z obszaru roboczego lub przejdź do folderu, który zawiera aplikację funkcji.Select folder: Choose a folder from your workspace or browse to one that contains your function app. Nie zobaczysz tego, jeśli masz już otwartą prawidłową aplikację funkcji.You won't see this if you already have a valid function app opened.

    • Wybierz subskrypcję: wybierz subskrypcję do użycia.Select subscription: Choose the subscription to use. Nie zobaczysz tego, jeśli masz tylko jedną subskrypcję.You won't see this if you only have one subscription.

    • Wybierz Aplikacja funkcji na platformie Azure: wybierz opcję - Create new Function App .Select Function App in Azure: Choose - Create new Function App. (Nie należy wybierać Advanced opcji, która nie jest objęta tym artykułem).(Don't choose the Advanced option, which isn't covered in this article.)

    • Wprowadź globalnie unikatową nazwę aplikacji funkcji: wpisz nazwę, która jest prawidłowa w ścieżce URL.Enter a globally unique name for the function app: Type a name that is valid in a URL path. Wpisana nazwa zostanie sprawdzona, aby upewnić się, że jest ona unikatowa w Azure Functions.The name you type is validated to make sure that it's unique in Azure Functions.

    • Wybierz lokalizację dla nowych zasobów: Aby uzyskać lepszą wydajność, wybierz region w sąsiedztwie.Select a location for new resources: For better performance, choose a region near you.

  3. Po zakończeniu następujące zasoby platformy Azure są tworzone w ramach subskrypcji przy użyciu nazw opartych na nazwie aplikacji funkcji:When completed, the following Azure resources are created in your subscription, using names based on your function app name:

    • Grupa zasobów, która jest kontenerem logicznym dla powiązanych zasobów.A resource group, which is a logical container for related resources.
    • Standardowe konto usługi Azure Storage, które zachowuje stan i inne informacje o projektach.A standard Azure Storage account, which maintains state and other information about your projects.
    • Plan zużycia, który definiuje podstawowego hosta dla aplikacji funkcji bezserwerowej.A consumption plan, which defines the underlying host for your serverless function app.
    • Aplikacja funkcji, która zapewnia środowisko do wykonywania kodu funkcji.A function app, which provides the environment for executing your function code. Aplikacja funkcji umożliwia grupowanie funkcji jako jednostki logicznej, co ułatwia zarządzanie, wdrażanie i udostępnianie zasobów w ramach tego samego planu hostingu.A function app lets you group functions as a logical unit for easier management, deployment, and sharing of resources within the same hosting plan.
    • Wystąpienie Application Insights połączone z aplikacją funkcji, która śledzi użycie funkcji bezserwerowej.An Application Insights instance connected to the function app, which tracks usage of your serverless function.

    Po utworzeniu aplikacji funkcji i zastosowaniu pakietu wdrożeniowego zostanie wyświetlone powiadomienie.A notification is displayed after your function app is created and the deployment package is applied.

  4. Wybierz pozycję Wyświetl dane wyjściowe w tym powiadomieniu, aby wyświetlić wyniki tworzenia i wdrażania, w tym utworzone zasoby platformy Azure.Select View Output in this notification to view the creation and deployment results, including the Azure resources that you created. W przypadku odrzucenia powiadomienia wybierz ikonę dzwonka w prawym dolnym rogu, aby zobaczyć ją ponownie.If you miss the notification, select the bell icon in the lower right corner to see it again.

    Utwórz pełne powiadomienie

Uruchamianie funkcji na platformie AzureRun the function in Azure

  1. Wróć do obszaru Azure: Functions na pasku bocznym, a następnie rozwiń nową aplikację funkcji w ramach subskrypcji.Back in the Azure: Functions area in the side bar, expand the new function app under your subscription. Rozwiń węzeł funkcje , kliknij prawym przyciskiem myszy (Windows) lub Ctrl- kliknij (macOS) w HttpExample , a następnie wybierz polecenie Kopiuj adres URL funkcji.Expand Functions , right-click (Windows) or Ctrl - click (macOS) on HttpExample , and then choose Copy function URL.

    Skopiuj adres URL funkcji dla nowego wyzwalacza HTTP

  2. Wklej ten adres URL żądania HTTP na pasku adresu przeglądarki, Dodaj name ciąg zapytania na ?name=Functions końcu tego adresu URL, a następnie wykonaj żądanie.Paste this URL for the HTTP request into your browser's address bar, add the name query string as ?name=Functions to the end of this URL, and then execute the request. Adres URL, który wywołuje funkcję wyzwalaną przez protokół HTTP, powinien mieć następujący format:The URL that calls your HTTP-triggered function should be in the following format:

    http://<FUNCTION_APP_NAME>.azurewebsites.net/api/httpexample?name=Functions
    

    Poniższy przykład przedstawia odpowiedź w przeglądarce do zdalnego żądania GET zwróconego przez funkcję:The following example shows the response in the browser to the remote GET request returned by the function:

    Odpowiedź funkcji wyświetlona w przeglądarce

Oczyszczanie zasobówClean up resources

Po przeniesieniu do następnego kroku i dodaniu powiązania kolejki usługi Azure Storage do funkcji należy zachować wszystkie Twoje zasoby, aby skompilować, co już zostało zrobione.When you continue to the next step and add an Azure Storage queue binding to your function, you'll need to keep all your resources in place to build on what you've already done.

W przeciwnym razie można wykonać poniższe kroki, aby usunąć aplikację funkcji i powiązane z nią zasoby, aby uniknąć ponoszenia dalszych kosztów.Otherwise, you can use the following steps to delete the function app and its related resources to avoid incurring any further costs.

  1. W Visual Studio Code naciśnij klawisz F1 , aby otworzyć paletę poleceń.In Visual Studio Code, press F1 to open the command palette. W palecie poleceń Wyszukaj i wybierz Azure Functions: Open in portal .In the command palette, search for and select Azure Functions: Open in portal.

  2. Wybierz aplikację funkcji i naciśnij klawisz Enter.Choose your function app, and press Enter. Strona aplikacji funkcji zostanie otwarta w Azure Portal.The function app page opens in the Azure portal.

  3. Na karcie Przegląd wybierz link nazwany obok pozycji Grupa zasobów.In the Overview tab, select the named link next to Resource group.

    Wybierz grupę zasobów do usunięcia ze strony aplikacji funkcji.

  4. Na stronie Grupa zasobów zapoznaj się z listą dołączonych zasobów i sprawdź, czy chcesz je usunąć.In the Resource group page, review the list of included resources, and verify that they are the ones you want to delete.

  5. Wybierz pozycję Usuń grupę zasobów , a następnie postępuj zgodnie z instrukcjami.Select Delete resource group , and follow the instructions.

    Usuwanie może potrwać kilka minut.Deletion may take a couple of minutes. Po jego zakończeniu przez kilka sekund będzie widoczne powiadomienie.When it's done, a notification appears for a few seconds. Możesz również wybrać ikonę dzwonka w górnej części strony, aby wyświetlić powiadomienie.You can also select the bell icon at the top of the page to view the notification.

Aby dowiedzieć się więcej o kosztach funkcji, zobacz szacowanie kosztów planu zużycia.To learn more about Functions costs, see Estimating Consumption plan costs.

Następne krokiNext steps

W programie Visual Studio Code utworzono aplikację funkcji z prostą funkcją wyzwalaną przez protokół HTTP.You have used Visual Studio Code to create a function app with a simple HTTP-triggered function. W następnym artykule można rozszerzyć tę funkcję, dodając powiązanie danych wyjściowych.In the next article, you expand that function by adding an output binding. To powiązanie zapisuje ciąg z żądania HTTP do wiadomości w kolejce usługi Azure Queue Storage.This binding writes the string from the HTTP request to a message in an Azure Queue Storage queue.