快速入門：使用 Visual Studio Code 在 Azure 中建立 C# 函式

發行項
03/21/2024

本文建立的 HTTP 觸發函式會在 .NET 8 上以隔離式背景工作處理序執行。如需 C# 函式支援的 .NET 版本資訊，請參閱支援的版本。

本文還有 CLI 型版本。

完成本快速入門後，您的 Azure 帳戶中會產生幾美分或更少的少許費用。

這段影片示範如何使用 VS Code 在 Azure 中建立 C# 函式。

下列各節也會說明影片中的步驟。

設定您的環境

開始使用之前，請先確定您具備下列必要項目︰

具有有效訂用帳戶的 Azure 帳戶。免費建立帳戶。
.NET 6.0 SDK，且在以 .NET 7.0 為目標時選擇性地需要 .NET 7.0 SDK。
其中一個支援平台上的 Visual Studio Code。
適用於 Visual Studio Code 的 C# 延伸模組。
適用於 Visual Studio Code 的 Azure Functions 擴充功能。

安裝或更新 Core Tools

適用於 Visual Studio Code 的 Azure Functions 延伸模組會整合 Azure Functions Core Tools，讓您可以使用 Azure Functions 執行階段，在 Visual Studio Code 本機執行和偵錯函式。開始之前，最好在本機安裝 Core Tools，或更新現有的安裝以使用最新版本。

在 Visual Studio Code 中，選取 F1 以開啟命令選擇區，然後搜尋並執行命令 Azure Functions: 安裝或更新 Core Tools。

此命令會啟動最新版 Core Tools 的套件型安裝。

建立本機專案

在本區段中，您會使用 Visual Studio Code，以 C# 建立本機 Azure Functions 專案。稍後在本文中，您會將函式程式碼發佈至 Azure。

選擇 [活動] 列中的 Azure 圖示，然後在 [工作區] (本機) 區域中選取 + 按鈕，選擇下拉式清單中的 [建立函數]。收到提示時，選擇 [建立新專案]。
選取專案工作區的目錄位置，並選擇 [選取]。您應建立新資料夾，或為專案工作區選擇空白資料夾。請勿選擇已屬於工作區一部分的專案資料夾。

提示中會提供下列資訊：

提示	選取項目
為您的函式專案選取語言	選擇 `C#`。
選取 .NET 執行階段	選擇 `.NET 8.0 Isolated (LTS)`。
為專案的第一個函式選取範本	選擇 `HTTP trigger`.¹
提供函式名稱	輸入 `HttpExample`。
提供命名空間	輸入 `My.Functions`。
授權等級	選擇 `Anonymous`，讓任何人都能呼叫您的函式端點。若要了解授權層級，請參閱授權金鑰。
選取您開啟專案的方式	選取 `Open in current window`。

¹ 依據 VS Code 設定，您可能需要使用 Change template filter 選項來查看完整的範本清單。

Visual Studio Code 會使用提供的資訊，產生具有 HTTP 觸發程序的 Azure Functions 專案。您可以在 Explorer 中檢視本機專案檔。如需已建立檔案的詳細資訊，請參閱產生的專案檔。

在本機執行函式

Visual Studio Code 可與 Azure Functions Core 工具整合，讓您能夠先在本機開發電腦上執行此專案，再發佈至 Azure。如果您尚未在本機安裝 Core Tools，系統會在您第一次執行專案時提示您安裝。

若要呼叫您的函式，請按 F5 以啟動函式應用程式專案。 [終端] 面板會顯示核心工具的輸出。您的應用程式會在 [終端] 面板中啟動。您可以查看在本機所執行 HTTP 觸發函式的 URL 端點。

如果您尚未安裝 Core Tools，請在系統提示安裝時選取 [安裝] 來安裝 Core Tools。
如果在 Windows 上執行時遇到問題，請確定 Visual Studio Code 的預設終端機未設定為 WSL Bash。
執行 Core Tools 時，移至 [Azure: Functions] 區域。在 [函式] 下方，展開 [本機專案]>[函式]。以滑鼠右鍵按一下 (Windows) 或 Ctrl - 點擊 (macOS) HttpExample 函式，並選擇 [立即執行函式...]。
在 [輸入要求本文] 中，按下 Enter 向您的函式傳送要求訊息。
當函式在本機執行並傳回回應時，會在 Visual Studio Code 中引發通知。 [終端機] 面板會顯示函數執行的相關資訊於。
按 Ctrl + C 以停止 Core Tools，並中斷偵錯工具的連線。

檢查本機電腦上的函數正常執行後，便可使用 Visual Studio Code 將專案直接發佈至 Azure。

您必須先登入 Azure，才能建立 Azure 資源或發布應用程式。

如果您尚未登入，請選擇 [活動] 列中的 Azure 圖示。然後在 [資源] 區域中，選擇 [登入 Azure...]。

如果您已登入，而且可以看到現有的訂閱，請移至下一節。如果您尚未擁有 Azure 帳戶，請選擇 [建立 Azure 帳戶...]。學生可以選擇 [建立 Azure 學生版帳戶...]。
當在瀏覽器中收到提示時，請使用您的 Azure 帳戶認證選擇 Azure 帳戶並登入。如果您建立新的帳戶，可以在帳戶建立之後登入。
成功登入之後，即可關閉新的瀏覽器視窗。屬於您 Azure 帳戶的訂用帳戶會顯示在提要欄位中。

在 Azure 中建立函式應用程式

在此區段中，您會在 Azure 訂用帳戶中建立函式應用程式和相關的資源。

選擇 [活動] 列中的 Azure 圖示。然後在 [資源] 區域中，選取 + 圖示並選擇 [在 Azure 中建立函數應用程式] 選項。

提示中會提供下列資訊：

提示	選取項目
選取訂用帳戶	選擇要使用的訂用帳戶。當您只有一個訂閱顯示在 [資源] 底下時，就不會看到此提示。
輸入函數應用程式的全域唯一名稱	輸入在 URL 路徑中有效的名稱。您鍵入的名稱會經過驗證，確定其在 Azure Functions 中是唯一。
選取執行階段堆疊	選擇您在本機上執行的語言版本。
選取新資源的位置	若要獲得較佳的效能，請選擇您附近的區域。

該延伸模組會在 [Azure: 活動記錄] 面板顯示正在 Azure 建立的個別資源狀態。

建立 Azure 資源的記錄

建立完成時，您的訂閱中會建立下列 Azure 資源。資源會根據您的函數應用程式名稱命名：
- 資源群組，這是相關資源的邏輯容器。
- 標準 Azure 儲存體帳戶，其可維護專案的狀態和其他資訊。
- 函數應用程式，其提供執行函式程式碼的環境。函數應用程式可讓您將函式以邏輯單位分組，方便您在相同的主控方案中管理、部署及共用資源。
- App Service 方案，其定義函數應用程式的基礎主機。
- 連線至函數應用程式的 Application Insights 執行個體，可追蹤應用程式中函式的使用量。
建立函式應用程式並套用部署套件之後，即會顯示通知。

提示

根據預設，系統會依照您提供的函數應用程式名稱建立函數應用程式所需的 Azure 資源，並且預設會建立在與函數應用程式相同的新資源群組中。如果您想自訂這些資源的名稱或重複使用現有的資源，必須改為使用進階建立選項發佈專案。

將專案部署至 Azure

重要

部署至現有的函數應用程式一律會覆寫該應用程式在 Azure 中的內容。

在 Azure 活動的 [資源] 區域中，找出您剛才建立的函數應用程式資源，以滑鼠右鍵按一下該資源，然後選取 [部署至函數應用程式...]。
當系統提示您覆寫先前的部署時，請選取 [部署]，將函式程式碼部署至新的函數應用程式資源。
部署完成時，選取 [檢視輸出] 即可檢視建立和部署結果，包括您所建立的 Azure 資源。如果您錯過通知，請選取右下角的鈴鐺圖示，以再次查看。

在 Azure 中執行函數

返回提要欄位中的 [資源] 區域，依序展開您的訂閱和新函數應用程式，以及 [函式]。以滑鼠右鍵按一下 (Windows) 或 Ctrl - 點擊 (macOS) HttpExample 函式，並選擇 [立即執行函式...]。
在 [輸入要求本文] 中，會看到 { "name": "Azure" } 的要求訊息本文值。請按 Enter 鍵，將此要求訊息傳送至您的函式。
當函式在 Azure 執行並傳回回應時，會在 Visual Studio Code 中引發通知。