將 .NET 應用程式從內含式模型遷移至隔離的背景工作角色模型

發行項
06/23/2024

重要

內含式模型支援將於 2026 年 11 月 10 日結束。強烈建議您遵循本文中的指示，將應用程式移轉至隔離式背景工作角色模型。

本文將逐步引導您完成將 .NET 函數應用程式從內含式模型安全地遷移至隔離背景工作角色模型的程序。若要了解這些模型之間的高階差異，請參閱執行模式比較。

本指南假設您的應用程式是在 Functions 執行階段 4.x 版上執行。若非如此，您應該改為遵循升級主機版本的指南：

這些主機版本移轉指南也會協助您在處理隔離背景工作角色模型時，遷移至隔離的背景工作角色模型。

識別要移轉的函數應用程式

使用下列 Azure PowerShell 指令碼，以在您的訂用帳戶中產生目前使用內含式模型的函數應用程式清單。

指令碼會使用 Azure PowerShell 目前設定要使用的訂用帳戶。您可以先執行 Set-AzContext -Subscription '<YOUR SUBSCRIPTION ID>'，並以您想要評估的訂用帳戶識別碼取代 <YOUR SUBSCRIPTION ID>，以變更訂用帳戶。

$FunctionApps = Get-AzFunctionApp

$AppInfo = @{}

foreach ($App in $FunctionApps)
{
     if ($App.Runtime -eq 'dotnet')
     {
          $AppInfo.Add($App.Name, $App.Runtime)
     }
}

$AppInfo

選擇您的目標 .NET 版本

在 Functions 執行階段 4.x 版上，您的 .NET 函數應用程式在使用內含式模型時，會以 .NET 6 為目標。

當您將函數應用程式移轉時，您有機會選擇 .NET 的目標版本。您可以將 C# 專案更新為下列其中一個 Functions 4.x 版可支援的 .NET 版本：

.NET 版本	.NET 官方支援原則版本類型	Functions 處理序模型^1、2
.NET 8	LTS (2026 年 11 月 10 日終止支援)	隔離式背景工作角色模型、同處理序模型^2、3
.NET 6	LTS (2024 年 11 月 12 日終止支援)	隔離式背景工作角色模型、同處理序模型²
.NET Framework 4.8	請參閱原則	隔離式背景工作角色模型

¹ 隔離式背景工作角色模型支援 .NET 的長期支援 (LTS) 和標準期限支援 (STS) 版本，以及 .NET Framework。同處理序模型僅支援 .NET 的 LTS 版本，結尾為 .NET 8。如需兩個模型之間的完整特性和功能比較，請參閱內含式和隔離式背景工作處理序 .NET Azure Functions 之間的差異。

² 同處理序模型的支援會於 2026 年 11 月 10 日結束。如需詳細資訊，請參閱此支援公告。如需持續的完整支援，您應該將應用程式移轉至隔離的背景工作角色模型。

³ 尚未針對 Linux、針對裝載於 App Service 環境中的應用程式，或針對主權雲端中的應用程式，啟用以使用同處理序模型的 .NET 8 為目標。更新將透過 GitHub 上的此追蹤執行緒傳達。

提示

建議您在隔離的背景工作角色模型上升級至 .NET 8。 這會提供完整發行版本的快速移轉路徑，以及 .NET 所提供最長的支援時間範圍。

本指南未提供 .NET 7 或 .NET 6 的特定範例。如果您需要以這些版本為目標，可以調整 .NET 8 範例。

為移轉做準備

如果您尚未這麼做，請使用 Azure PowerShell 來識別需要在目前 Azure 訂用帳戶中遷移的應用程式清單。

將應用程式遷移至隔離背景工作角色模型之前，您應該徹底檢閱本指南的內容，並熟悉隔離背景工作角色模型的功能，以及這兩個模型之間的差異。

若要遷移應用程式，您將：

完成遷移本機專案以將本機專案遷移至隔離背景工作角色模型中的步驟。
移轉專案之後，請使用 4.x 版的 Azure Functions Core Tools，在本機完整測試應用程式。
將 Azure 中的函數應用程式更新為隔離模型。

遷移本機專案

本節概述您需要對本機專案進行的各種變更，以將其移至隔離的背景工作角色模型。某些步驟會根據您的目標 .NET 版本而變更。使用索引標籤來選取符合所需版本的指示。這些步驟假設本機 C# 專案，如果您的應用程式改用 C# 指令碼 (.csx 檔案)，您應該先轉換成專案模型，然後再繼續進行。

提示

如果您要移至 .NET 的 LTS 或 STS 版本，可以使用 .NET 升級小幫手來自動進行下列各節所述的許多變更。

首先，您將轉換專案檔並更新相依性。如您所見，您會看到專案的建置錯誤。在後續步驟中，您將進行對應的變更，以移除這些錯誤。

專案檔

下列範例是在 4.x 版上使用 .NET 6 執行的 .csproj 專案檔：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
    <AzureFunctionsVersion>v4</AzureFunctionsVersion>
    <RootNamespace>My.Namespace</RootNamespace>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Microsoft.NET.Sdk.Functions" Version="4.1.1" />
  </ItemGroup>
  <ItemGroup>
    <None Update="host.json">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </None>
    <None Update="local.settings.json">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
      <CopyToPublishDirectory>Never</CopyToPublishDirectory>
    </None>
  </ItemGroup>
</Project>

使用下列其中一個程序來更新此 XML 檔案，以在隔離的背景工作角色型中執行：

.NET 8
.NET Framework 4.8

這些步驟假設本機 C# 專案，如果您的應用程式改用 C# 指令碼 (.csx 檔案)，您應該先轉換成專案模型，然後再繼續進行。

.csproj XML 專案檔中需要下列變更：

設定 PropertyGroup 的值。TargetFramework 至 net8.0。
設定 PropertyGroup 的值。AzureFunctionsVersion 至 v4。
將下列 OutputType 元素新增至 PropertyGroup：
```
<OutputType>Exe</OutputType>
```

在 ItemGroup 中。在 PackageReference 清單中，將 Microsoft.NET.Sdk.Functions 的套件參考取代為下列參考：

  <FrameworkReference Include="Microsoft.AspNetCore.App" />
  <PackageReference Include="Microsoft.Azure.Functions.Worker" Version="1.21.0" />
  <PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" Version="1.17.2" />
  <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore" Version="1.2.1" />
  <PackageReference Include="Microsoft.ApplicationInsights.WorkerService" Version="2.22.0" />
  <PackageReference Include="Microsoft.Azure.Functions.Worker.ApplicationInsights" Version="1.2.0" />

記下 Microsoft.Azure.WebJobs.* 命名空間中其他套件的任何參考。您將在稍後的步驟中取代這些套件。

新增下列新的 ItemGroup：

<ItemGroup>
  <Using Include="System.Threading.ExecutionContext" Alias="ExecutionContext"/>
</ItemGroup>

進行這些變更之後，更新的專案看起來應該像下列範例：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <AzureFunctionsVersion>v4</AzureFunctionsVersion>
    <RootNamespace>My.Namespace</RootNamespace>
    <OutputType>Exe</OutputType>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>
  <ItemGroup>
    <FrameworkReference Include="Microsoft.AspNetCore.App" />
    <PackageReference Include="Microsoft.Azure.Functions.Worker" Version="1.21.0" />
    <PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" Version="1.17.2" />
    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore" Version="1.2.1" />
    <PackageReference Include="Microsoft.ApplicationInsights.WorkerService" Version="2.22.0" />
    <PackageReference Include="Microsoft.Azure.Functions.Worker.ApplicationInsights" Version="1.2.0" />
    <!-- Other packages may also be in this list -->
  </ItemGroup>
  <ItemGroup>
    <None Update="host.json">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </None>
    <None Update="local.settings.json">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
      <CopyToPublishDirectory>Never</CopyToPublishDirectory>
    </None>
  </ItemGroup>
  <ItemGroup>
    <Using Include="System.Threading.ExecutionContext" Alias="ExecutionContext"/>
  </ItemGroup>
</Project>

這些步驟假設本機 C# 專案，如果您的應用程式改用 C# 指令碼 (.csx 檔案)，您應該先轉換成專案模型，然後再繼續進行。

.csproj XML 專案檔中需要下列變更：

設定 PropertyGroup 的值。TargetFramework 至 net48。
設定 PropertyGroup 的值。AzureFunctionsVersion 至 v4。
將下列 OutputType 元素新增至 PropertyGroup：
```
<OutputType>Exe</OutputType>
```

在 ItemGroup 中。在 PackageReference 清單中，將 Microsoft.NET.Sdk.Functions 的套件參考取代為下列參考：

  <PackageReference Include="Microsoft.Azure.Functions.Worker" Version="1.21.0" />
  <PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" Version="1.16.4" />
  <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http" Version="3.1.0" />
  <PackageReference Include="Microsoft.ApplicationInsights.WorkerService" Version="2.22.0" />
  <PackageReference Include="Microsoft.Azure.Functions.Worker.ApplicationInsights" Version="1.2.0" />

記下 Microsoft.Azure.WebJobs.* 命名空間中其他套件的任何參考。您將在稍後的步驟中取代這些套件。

新增下列新的 ItemGroup：

<ItemGroup>
  <Folder Include="Properties\" />
</ItemGroup>

進行這些變更之後，更新的專案看起來應該像下列範例：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net48</TargetFramework>
    <AzureFunctionsVersion>v4</AzureFunctionsVersion>
    <RootNamespace>My.Namespace</RootNamespace>
    <OutputType>Exe</OutputType>
  </PropertyGroup>
  <ItemGroup>
      <PackageReference Include="Microsoft.Azure.Functions.Worker" Version="1.21.0" />
      <PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" Version="1.16.4" />
      <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http" Version="3.1.0" />
      <PackageReference Include="Microsoft.ApplicationInsights.WorkerService" Version="2.22.0" />
      <PackageReference Include="Microsoft.Azure.Functions.Worker.ApplicationInsights" Version="1.2.0" />
    <!-- Other packages may also be in this list -->
  </ItemGroup>
  <ItemGroup>
    <None Update="host.json">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </None>
    <None Update="local.settings.json">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
      <CopyToPublishDirectory>Never</CopyToPublishDirectory>
    </None>
  </ItemGroup>
  <ItemGroup>
    <Folder Include="Properties\" />
  </ItemGroup>
</Project>

套件參考

移轉至隔離的背景工作角色模型時，您需要變更應用程式參考的套件。

如果您尚未這麼做，請更新專案以參考最新穩定版本的：

根據應用程式所使用的觸發程序和繫結，您的應用程式可能需要參考一組不同的套件。下表顯示一些最常用延伸模組的取代項目：

案例	套件參考的變更
計時器觸發程序	加 Microsoft.Azure.Functions.Worker.Extensions.Timer
儲存體繫結	Replace `Microsoft.Azure.WebJobs.Extensions.Storage` 取代為 Microsoft.Azure.Functions.Worker.Extensions.Storage.Blobs、 Microsoft.Azure.Functions.Worker.Extensions.Storage.Queues 和 Microsoft.Azure.Functions.Worker.Extensions.Tables
Blob 繫結	將參考取代為 `Microsoft.Azure.WebJobs.Extensions.Storage.Blobs` 最新版本的 Microsoft.Azure.Functions.Worker.Extensions.Storage.Blobs
佇列繫結	將參考取代為 `Microsoft.Azure.WebJobs.Extensions.Storage.Queues` 最新版本的 Microsoft.Azure.Functions.Worker.Extensions.Storage.Queues
資料表繫結	將參考取代為 `Microsoft.Azure.WebJobs.Extensions.Tables` 最新版本的 Microsoft.Azure.Functions.Worker.Extensions.Tables
Cosmos DB 繫結	將參考取代為 `Microsoft.Azure.WebJobs.Extensions.CosmosDB` 和/或 `Microsoft.Azure.WebJobs.Extensions.DocumentDB` 最新版本的 Microsoft.Azure.Functions.Worker.Extensions.CosmosDB
服務匯流排繫結	將參考取代為 `Microsoft.Azure.WebJobs.Extensions.ServiceBus` 最新版本的 Microsoft.Azure.Functions.Worker.Extensions.ServiceBus
事件中樞繫結	將參考取代為 `Microsoft.Azure.WebJobs.Extensions.EventHubs` 最新版本的 Microsoft.Azure.Functions.Worker.Extensions.EventHubs
事件方格繫結	將參考取代為 `Microsoft.Azure.WebJobs.Extensions.EventGrid` 最新版本的 Microsoft.Azure.Functions.Worker.Extensions.EventGrid
SignalR Service 繫結	將參考取代為 `Microsoft.Azure.WebJobs.Extensions.SignalRService` 最新版本的 Microsoft.Azure.Functions.Worker.Extensions.SignalRService
長期函式	將參考取代為 `Microsoft.Azure.WebJobs.Extensions.DurableTask` 最新版本的 Microsoft.Azure.Functions.Worker.Extensions.DurableTask
長期函式 (SQL 儲存體提供者)	將參考取代為 `Microsoft.DurableTask.SqlServer.AzureFunctions` 最新版本的 Microsoft.Azure.Functions.Worker.Extensions.DurableTask.SqlServer
長期函式 (Netherite 儲存體提供者)	將參考取代為 `Microsoft.Azure.DurableTask.Netherite.AzureFunctions` 最新版本的 Microsoft.Azure.Functions.Worker.Extensions.DurableTask.Netherite
SendGrid 繫結	將參考取代為 `Microsoft.Azure.WebJobs.Extensions.SendGrid` 最新版本的 Microsoft.Azure.Functions.Worker.Extensions.SendGrid
Kafka 繫結	將參考取代為 `Microsoft.Azure.WebJobs.Extensions.Kafka` 最新版本的 Microsoft.Azure.Functions.Worker.Extensions.Kafka
RabbitMQ 繫結	將參考取代為 `Microsoft.Azure.WebJobs.Extensions.RabbitMQ` 最新版本的 Microsoft.Azure.Functions.Worker.Extensions.RabbitMQ
相依性插入和啟動設定	移除對下列項目的參考： `Microsoft.Azure.Functions.Extensions` (隔離式背景工作角色模型預設會提供這項功能。)

如需要納入考量的完整延伸模組清單，請參閱支援的繫結，並參閱每個延伸模組的文件，以取得隔離式處理序模型的完整安裝指示。對於您要以其作為目標的任何套件，請務必安裝其最新穩定版本。

提示

此程序期間對延伸模組版本所做的任何變更，也可能需要您更新 host.json 檔案。請務必閱讀您使用的每個延伸模組的文件。例如，服務匯流排延伸模組在 4.x 和 5.x 版之間的結構有重大變更。如需詳細資訊，請參閱 Azure Functions 的 Azure 服務匯流排繫結。

隔離式背景工作角色模型應用程式不應該參考 Microsoft.Azure.WebJobs.* 命名空間或 Microsoft.Azure.Functions.Extensions 中的任何套件。 如果您有任何對這些項目的其餘參考，則應該移除這些參考。

提示

您的應用程式也可能相依於 Azure SDK 類型，無論是作為觸發程式和繫結的一部分，還是獨立相依性。您也應該利用這個機會來更新這些項目。最新版的 Functions 延伸模組會與適用於 .NET 的 Azure SDK 最新版本搭配運作，其幾乎所有套件的格式都是 Azure.*。

program.cs 檔案

移轉以在隔離式背景工作處理序中執行時，您必須使用下列內容，將 Program.cs 檔案新增至專案：

.NET 8
.NET Framework 4.8

using Microsoft.Azure.Functions.Worker;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

var host = new HostBuilder()
    .ConfigureFunctionsWebApplication()
    .ConfigureServices(services => {
        services.AddApplicationInsightsTelemetryWorkerService();
        services.ConfigureFunctionsApplicationInsights();
    })
    .Build();

host.Run();

此範例包含 ASP.NET Core 整合，以改善效能，並在您的應用程式使用 HTTP 觸發程序時提供熟悉的程式設計模型。如果您不打算使用 HTTP 觸發程序，可以將對 ConfigureFunctionsWebApplication 的呼叫取代為對 ConfigureFunctionsWorkerDefaults 的呼叫。如果這樣做，您可以從專案檔中移除對 Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore 的參考。不過，為了獲得最佳效能，甚至是其他觸發程序類型的函式，您也應該保留對 ASP.NET Core 的 FrameworkReference。

using Microsoft.Extensions.Hosting;
using Microsoft.Azure.Functions.Worker;

namespace Company.FunctionApp
{
    internal class Program
    {
        static void Main(string[] args)
        {
            FunctionsDebugger.Enable();

            var host = new HostBuilder()
                .ConfigureFunctionsWorkerDefaults()
                .ConfigureServices(services => {
                    services.AddApplicationInsightsTelemetryWorkerService();
                    services.ConfigureFunctionsApplicationInsights();
                })
                .Build();
            host.Run();
        }
    }
}

Program.cs 檔案會取代具有 FunctionsStartup 屬性的任何檔案，通常為 Startup.cs 檔案。在 FunctionsStartup 程式碼參考 IFunctionsHostBuilder.Services 的位置，您可以改為在 Program.cs 中 HostBuilder 的 .ConfigureServices() 方法內新增陳述式。若要深入了解如何使用 Program.cs，請參閱隔離的背景工作角色模型指南中的啟動和設定。

以上預設 Program.cs 範例包括設定隔離背景工作角色模型的 Application Insights 整合。在您的 Program.cs 中，您也必須設定任何應套用至專案中程式碼所產生記錄的任何記錄篩選。在隔離的背景工作角色模型中，host.json 檔案只會控制 Functions 主機執行階段發出的事件。如果您未在 Program.cs 中設定篩選規則，可能會看到遙測中各種類別的記錄層級差異。

雖然您可以將自訂組態來源註冊為 HostBuilder 的一部分，但請注意，這些同樣僅適用於您專案中的程式碼。平台也需要觸發和繫結組態，這應該透過應用程式設定、Key Vault 參考，或應用程式組態參考功能來提供。

一旦您將現有 FunctionsStartup 中的所有內容移至 Program.cs 檔案之後，就可以刪除 FunctionsStartup 屬性及其套用的類別。

函式簽章變更

一些主要類型會在內含式模型與隔離的背景工作角色模型之間變更。其中許多都與組成函式簽章的屬性、參數和傳回型別有關。針對每個函式，您必須對下列項目進行變更：

函式屬性 (也會設定函式的名稱)
函式如何取得 ILogger/ILogger<T>
觸發程序與繫結屬性和參數

本節的其餘內容將引導您完成這些步驟。

函式屬性

FunctionName 屬性會由隔離背景工作角色模型中的 Function 屬性取代。新的屬性具有相同的簽章，唯一的差異在於名稱。因此，您可以跨專案執行字串取代。

記錄

在內含式模型中，您可以在函式中包含其他 ILogger 參數，或使用相依性插入來取得 ILogger<T>。如果您已經使用相依性插入，則相同的機制會在隔離的背景工作角色模型中運作。

不過，對於仰賴 ILogger 方法參數的任何 Functions，您必須進行變更。建議您使用相依性插入來取得 ILogger<T>。使用下列步驟來遷移函式的記錄機制：

在您的函式類別中，新增 private readonly ILogger<MyFunction> _logger; 屬性，並將 MyFunction 取代為函式類別的名稱。
為您的函式類別建立建構函式，其接受 ILogger<T> 做為參數：
```
public MyFunction(ILogger<MyFunction> logger) {
    _logger = logger;
}
```
將上述程式碼片段中的這兩個 MyFunction 執行個體取代為函式類別的名稱。
若要記錄函式程式碼中的作業，請將 ILogger 參數的參考取代為 _logger。
從函式簽章中移除 ILogger 參數。

若要深入了解，請參閱在隔離的背景工作角色模型中記錄。

觸發程序和繫結變更

當您在上一個步驟中變更套件參考時，即引進了觸發程序和繫結的錯誤，您現在將修正：

移除任何 using Microsoft.Azure.WebJobs; 陳述式。
新增 using Microsoft.Azure.Functions.Worker; 陳述式。
針對每個繫結屬性，變更屬性的名稱，如其參考文件中所指定，您可以在支援的繫結索引中找到該名稱。一般而言，屬性名稱會變更，如下所示：
- 觸發程序通常會維持以相同方式命名。 例如，QueueTrigger 是這兩個模型的屬性名稱。
- 輸入繫結通常需要將「輸入」新增至其名稱。 例如，如果您在內含式模型中使用 CosmosDB 輸入繫結屬性，現在會是 CosmosDBInput。
- 輸出繫結通常需要將「輸出」新增至其名稱。 例如，如果您在內含式模型中使用 Queue 輸出繫結屬性，現在會是 QueueOutput。
更新屬性參數以反映隔離的背景工作角色模型版本，如繫結的參考文件中所指定。

例如，在內含式模型中，Blob 輸出繫結是由包含 Access 屬性 (property) 的 [Blob(...)] 屬性 (attribute) 來表示。在隔離的背景工作角色模型中，Blob 輸出屬性會是 [BlobOutput(...)]。繫結不再需要 Access 屬性，因此可以移除該參數。因此，[Blob("sample-images-sm/{fileName}", FileAccess.Write, Connection = "MyStorageConnection")] 將成為 [BlobOutput("sample-images-sm/{fileName}", Connection = "MyStorageConnection")]。
將輸出繫結移出函式參數清單。如果您只有一個輸出繫結，您可以將此套用至函式的傳回型別。如果您有多個輸出，請為每個輸出建立具有屬性 (property) 的新類別，並將屬性 (attribute) 套用至這些屬性 (property)。若要深入了解，請參閱多個輸出繫結。
請參閱每個繫結的參考文件，以取得其可讓您繫結的目標類型。在某些情況下，您可能需要變更類型。針對輸出繫結，如果內含式模型版本使用 IAsyncCollector<T>，則您可以將此取代為繫結至目標類型的陣列：T[]。您也可以考慮將輸出繫結取代為其所代表服務的用戶端物件，可以是輸入繫結 (若有) 的繫結類型，或自行插入用戶端。
如果您的函式包含 IBinder 參數，請將其移除。將功能取代為其所代表服務的用戶端物件，可以是輸入繫結 (若有) 的繫結類型，或自行插入用戶端。
更新函式程式碼以使用任何新類型。

local.settings.json 檔案

local.settings.json 檔案只有在本機執行時才會使用。如需詳細資訊，請參閱本機設定檔。

從執行同處理序移轉以在隔離式背景工作處理序中執行時，您需要將 FUNCTIONS_WORKER_RUNTIME 值變更為 "dotnet-isolated"。請確定 local.settings.json 檔案具有至少有下列元素：

{
    "IsEncrypted": false,
    "Values": {
        "AzureWebJobsStorage": "UseDevelopmentStorage=true",
        "FUNCTIONS_WORKER_RUNTIME": "dotnet-isolated"
    }
}

您為 `AzureWebJobsStorage`` 設定的值可能不同。您不需要在移轉過程中變更其值。

host.json 檔案

您的 host.json 檔案不需要變更。不過，如果此檔案中的 Application Insights 組態來自您的同處理序模型專案，您可能需要在您的 Program.cs 檔案中進行其他變更。此 host.json 檔案只會控制來自 Functions 主機執行階段的記錄，而隔離的背景工作角色模型中，這些記錄中其中有一些會直接來自您的應用程式，讓您有更多控制權。如需如何篩選這些記錄的詳細資料，請參閱在隔離的背景工作模型中管理記錄層級。

其他程式碼變更

本節會醒目提示當您完成移轉時所要考量的其他程式碼變更。並非所有應用程式都需要這些變更，但您應該評估是否有任何變更與案例相關。

JSON 序列化

根據預設，隔離的背景工作角色模型會使用 System.Text.Json 進行 JSON 序列化。若要自訂序列化程式選項或切換至 JSON.NET (Newtonsoft.Json)，請參閱這些指示。

Application Insights 記錄層級和篩選

您可以從 Functions 主機執行階段和專案中的程式碼將記錄傳送至 Application Insights。 host.json 可讓您設定主機記錄的規則，但若要控制來自程式碼的記錄，您必須將篩選規則設定為 Program.cs 的一部分。如需如何篩選這些記錄的詳細資料，請參閱在隔離的背景工作模型中管理記錄層級。

範例函式移轉

HTTP 觸發程序範例

內含式模型的 HTTP 觸發程序看起來可能如下列範例所示：

using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Extensions.Http;
using Microsoft.Extensions.Logging;

namespace Company.Function
{
    public static class HttpTriggerCSharp
    {
        [FunctionName("HttpTriggerCSharp")]
        public static IActionResult Run(
            [HttpTrigger(AuthorizationLevel.Function, "get", Route = null)] HttpRequest req,
            ILogger log)
        {
            log.LogInformation("C# HTTP trigger function processed a request.");

            return new OkObjectResult($"Welcome to Azure Functions, {req.Query["name"]}!");
        }
    }
}

移轉後版本的 HTTP 觸發程序可能如下列範例：

.NET 8
.NET Framework 4.8

using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Azure.Functions.Worker;
using Microsoft.Extensions.Logging;

namespace Company.Function
{
    public class HttpTriggerCSharp
    {
        private readonly ILogger<HttpTriggerCSharp> _logger;

        public HttpTriggerCSharp(ILogger<HttpTriggerCSharp> logger)
        {
            _logger = logger;
        }

        [Function("HttpTriggerCSharp")]
        public IActionResult Run(
            [HttpTrigger(AuthorizationLevel.Function, "get")] HttpRequest req)
        {
            _logger.LogInformation("C# HTTP trigger function processed a request.");

            return new OkObjectResult($"Welcome to Azure Functions, {req.Query["name"]}!");
        }
    }
}

using Microsoft.Azure.Functions.Worker;
using Microsoft.Azure.Functions.Worker.Http;
using Microsoft.Extensions.Logging;
using System.Net;

namespace Company.Function
{
    public class HttpTriggerCSharp
    {
        private readonly ILogger<HttpTriggerCSharp> _logger;

        public HttpTriggerCSharp(ILogger<HttpTriggerCSharp> logger)
        {
            _logger = logger;
        }

        [Function("HttpTriggerCSharp")]
        public HttpResponseData Run([HttpTrigger(AuthorizationLevel.Function, "get")] 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");

            response.WriteString($"Welcome to Azure Functions, {req.Query["name"]}!");

            return response;
        }
    }
}

在 Azure 中更新函數應用程式

將函數應用程式升級至隔離模型包含兩個步驟：

將 FUNCTIONS_WORKER_RUNTIME 應用程式設定設為 dotnet-isolated，以將函數應用程式的設定變更為使用隔離模型。請確定已同樣更新任何部署自動化。
將移轉的專案發佈至更新的函數應用程式。

在使用 Visual Studio 將隔離的背景工作角色模型專案發佈至使用內含式模型的現有函數應用程式時，系統會提示您在部署期間讓 Visual Studio 將函數應用程式進行更新。如此可同時完成這兩個步驟。

如果您需要將停機時間降到最低，請考慮使用預備位置，在 Azure 中使用更新設定測試及驗證遷移的程式碼。然後，您可以透過交換作業，將完全遷移的應用程式部署至生產位置。

完成這些步驟之後，您的應用程式即已完全遷移至隔離的模型。恭喜！視需要針對需要移轉的任何其他應用程式重複本指南中的步驟。

下一步

深入了解隔離式背景工作角色模型

共用方式為