快速入門：使用 Azure 應用程式組態建立 Azure Functions 應用程式

發行項
04/04/2024

在本快速入門中，您會將 Azure 應用程式組態服務納入 Azure Functions 應用程式，以集中儲存和管理與程式代碼分開的所有應用程式設定。

必要條件

具有有效訂用帳戶的 Azure 帳戶。免費建立一個。
應用程式組態存放區。建立存放區。
具有 Azure 開發工作負載的 Visual Studio。
如果您尚未隨 Visual Studio 一起安裝 Azure Functions 工具，

新增金鑰值

將下列金鑰值新增至應用程式組態存放區，並保留標籤和內容類型的預設值。如需如何使用 Azure 入口網站或 CLI 將金鑰值新增至存放區的詳細資訊，請移至建立金鑰值。

機碼	值
TestApp:Settings:Message	Azure 應用程式組態的資料

建立 Functions 應用程式

Visual Studio 中的 Azure Functions 專案範本會建立可發行至 Azure 中函數應用程式的 C# 類別庫專案。您可以使用函式應用程式將多個函式群組為邏輯單位，以方便管理、部署、調整和共用資源。

在 Visual Studio 功能表中，選取 [檔案]> [新增]> [專案]。
在 [建立新專案] 的搜尋方塊中輸入函式，選擇 [Azure Functions] 範本，然後選取 [下一步]。
在 [設定您的新專案] 中，輸入專案的專案名稱，然後選取 [建立]。函式應用程式名稱必須是有效的 C# 命名空間，因此不會使用底線、連字號或任何其他非英數字元。

針對 [建立新的 Azure Functions 應用程式] 設定，請使用下表中的值：

隔離式背景工作角色模型
內含式模型

設定	值	Description
.NET 版本	.NET 6 已隔離	此值會建立在隔離式背景工作處理序中執行的函式專案。隔離式背景工作處理序支援其他非 LTS 版本的 .NET 和 .NET Framework。如需詳細資訊，請參閱 Azure Functions 執行階段版本概觀。
函式範本	HTTP 觸發程序	此值會建立 HTTP 要求所觸發的函式。
儲存體帳戶 (AzureWebJobsStorage)	儲存體模擬器	因為 Azure 中的函數應用程式需要儲存體帳戶，所以當您將專案發佈至 Azure 時，就會指派或建立一個儲存體帳戶。 HTTP 觸發程式不會使用 Azure 儲存體帳戶連接字串；所有其他觸發程式類型都需要有效的 Azure 儲存體帳戶連接字串。
授權等級	匿名	建立的函式可以由任何用戶端觸發，而不需提供金鑰。此授權設定可以讓測試新函式變得簡單。如需金鑰和授權的詳細資訊，請參閱授權金鑰和 HTTP 和 Webhook 繫結。

Azure Functions 項目設定

重要

支援將於 2026 年 11 月 10 日結束進程模型。強烈建議您將應用程式移轉至隔離的背景工作模型，以取得完整支援。

設定	值	Description
.NET 版本	.NET 6	此值會建立一個函數專案，執行 Azure Functions 執行階段版本 4.x 的內含式。如需詳細資訊，請參閱 Azure Functions 執行階段版本概觀。
函式範本	HTTP 觸發程序	此值會建立 HTTP 要求所觸發的函式。
儲存體帳戶 (AzureWebJobsStorage)	儲存體模擬器	因為 Azure 中的函數應用程式需要儲存體帳戶，所以當您將專案發佈至 Azure 時，就會指派或建立一個儲存體帳戶。 HTTP 觸發程式不會使用 Azure 儲存體帳戶連接字串；所有其他觸發程式類型都需要有效的 Azure 儲存體帳戶連接字串。
授權等級	匿名	建立的函式可以由任何用戶端觸發，而不需提供金鑰。此授權設定可以讓測試新函式變得簡單。如需金鑰和授權的詳細資訊，請參閱授權金鑰和 HTTP 和 Webhook 繫結。

Azure Functions 項目設定

請確定您已將 [授權層級] 設定為 [匿名]。如果您選擇函式的預設層級，必須在要求中提供函式金鑰以存取您的函式端點。

選取 [建立] 以建立函式專案和 HTTP 觸發程序函數。

連線至應用程式組態存放區

此專案會在 .NET Azure Functions 中使用相依性插入，並將 Azure 應用程式組態新增為額外的組態來源。 Azure Functions 支援執行內含式或隔離程序。挑選符合您需求的。

以滑鼠右鍵按一下專案，然後選取 [管理 NuGet 套件]。在 [瀏覽] 索引標籤上，搜尋下列 NuGet 套件並新增至您的專案。
- 內含式
- 隔離式程序
- Microsoft.Extensions.Configuration.AzureAppConfiguration 4.1.0 版或更新版本
- Microsoft.Azure.Functions.Extensions 1.1.0 版或更新版本
- Microsoft.Azure.AppConfiguration.Functions.Worker

新增程式代碼以連線至 Azure 應用程式組態。

內含式
隔離式程序

使用下列程式碼，新增 Startup.cs 檔案。其會定義名為 Startup 的類別，以實作 FunctionsStartup 抽象類別。元件屬性用來指定 Azure Functions 啟動期間所使用的類型名稱。

方法ConfigureAppConfiguration會覆寫，Azure 應用程式組態提供者藉由呼叫 AddAzureAppConfiguration()新增為額外的組態來源。方法 Configure 會保留空白，因為此時您不需要註冊任何服務。

using System;
using Microsoft.Azure.Functions.Extensions.DependencyInjection;
using Microsoft.Extensions.Configuration;

[assembly: FunctionsStartup(typeof(FunctionApp.Startup))]

namespace FunctionApp
{
    class Startup : FunctionsStartup
    {
        public override void ConfigureAppConfiguration(IFunctionsConfigurationBuilder builder)
        {
            string cs = Environment.GetEnvironmentVariable("ConnectionString");
            builder.ConfigurationBuilder.AddAzureAppConfiguration(cs);
        }

        public override void Configure(IFunctionsHostBuilder builder)
        {
        }
    }
}

開啟 Program.cs 並更新 Main() 方法，如下所示。您可以藉由呼叫 AddAzureAppConfiguration()，將 Azure 應用程式組態提供者新增為額外的組態來源。

public static void Main()
{
    var host = new HostBuilder()
        .ConfigureAppConfiguration(builder =>
        {
            string cs = Environment.GetEnvironmentVariable("ConnectionString");
            builder.AddAzureAppConfiguration(cs);
        })
        .ConfigureFunctionsWorkerDefaults()
        .Build();

    host.Run();
}

開啟 Function1.cs，如果尚未存在，請新增下列命名空間。

using Microsoft.Extensions.Configuration;

新增或更新建構函式，以透過相依性插入取得的 IConfiguration 實例。

內含式
隔離式程序

private readonly IConfiguration _configuration;

public Function1(IConfiguration configuration)
{
    _configuration = configuration;
}

private readonly IConfiguration _configuration;

public Function1(ILoggerFactory loggerFactory, IConfiguration configuration)
{
    _logger = loggerFactory.CreateLogger<Function1>();
    _configuration = configuration;
}

Run更新方法以從組態讀取值。

內含式
隔離式程序

[FunctionName("Function1")]
public async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req, ILogger log)
{
    log.LogInformation("C# HTTP trigger function processed a request.");

    // Read configuration data
    string keyName = "TestApp:Settings:Message";
    string message = _configuration[keyName];

    return message != null
        ? (ActionResult)new OkObjectResult(message)
        : new BadRequestObjectResult($"Please create a key-value with the key '{keyName}' in App Configuration.");
}

注意

類別 Function1 和 Run 方法不應該是靜態的。如果已自動產生修飾詞， static 請移除修飾詞。

[Function("Function1")]
public HttpResponseData Run([HttpTrigger(AuthorizationLevel.Anonymous, "get", "post")] HttpRequestData req)
{
    _logger.LogInformation("C# HTTP trigger function processed a request.");

    var response = req.CreateResponse(HttpStatusCode.OK);
    response.Headers.Add("Content-Type", "text/plain; charset=utf-8");

    // Read configuration data
    string keyName = "TestApp:Settings:Message";
    string message = _configuration[keyName];

    response.WriteString(message ?? $"Please create a key-value with the key '{keyName}' in Azure App Configuration.");

    return response;
}

在本機測試函式

設定名為 ConnectionString 的環境變數，並將其設定為應用程式組態存放區的存取金鑰。如果您使用 Windows 命令提示字元，請執行下列命令，然後重新啟動命令提示字元以讓變更生效：
```
    setx ConnectionString "connection-string-of-your-app-configuration-store"
```
如果您使用 Windows PowerShell，請執行下列命令：
```
    $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
如果您使用 macOS 或 Linux，請執行下列命令：
```
    export ConnectionString='connection-string-of-your-app-configuration-store'
```
按 F5 測試您的函式。如果出現提示，請接受 Visual Studio 所發出要下載及安裝 Azure Functions Core (CLI) 工具的要求。您可能也需要啟用防火牆例外狀況，工具才能處理 HTTP 要求。
從 Azure Functions 執行階段輸出複製函式的 URL。
將 HTTP 要求的 URL 貼到您的瀏覽器位址列。下圖顯示瀏覽器中對於函式傳回之本機 GET 要求所做出的回應。