共用方式為


註冊 Azure Functions 繫結延伸模組

Azure Functions 運行時間會以原生方式執行 HTTP 和定時器觸發程式。 其他支援的 觸發程式和系結 的行為會在不同的擴充套件中實作。

.NET 類別庫專案會使用安裝在專案中做為 NuGet 套件的系結延伸模組。

延伸模組套件組合允許 non-.NET 應用程式使用系結延伸模組,而不需要與 .NET 基礎結構互動。

延伸模組套件組合

延伸模組套件組合會將一組預先定義的相容系結延伸模組新增至函式應用程式。 延伸模組套件組合已設定版本。 每個版本都包含一組特定的系結延伸模組,這些延伸模組會經過驗證以一起運作。 根據您在應用程式中所需的擴充功能,選取套件組合版本。

當您從 non-.NET 範本建立 Azure Functions 專案時,已在應用程式的 host.json 檔案中啟用延伸模組套件組合。

可能的話,請使用最新版本範圍來取得最佳的應用程式效能和最新功能的存取權。 若要深入瞭解擴充功能套件組合,請參閱 Azure Functions 擴充功能套件組合

在不太可能的情況下,您無法使用擴充功能套件組合,您必須改為 明確地安裝擴充功能

明確安裝延伸模組

針對已編譯的 C# 類別庫專案,您可以安裝所需的延伸模組 NuGet 套件,就像平常在應用程式中一樣。 如需詳細資訊,請參閱 Visual Studio Code 開發人員指南Visual Studio開發人員指南

請務必取得正確的套件,因為命名空間會根據執行模型而有所不同:

執行模型 Namespace
隔離的背景工作進程 Microsoft.Azure.Functions.Worker.Extensions.*
處理中 Microsoft.Azure.WebJobs.Extensions.*

函式提供 non-.NET 專案的延伸模組組合,其中包含一組已驗證為相容的系結延伸模組。 如果您在兩個或多個系結延伸模組之間發生相容性問題,請檢閱延伸模組版本的相容組合。 如需支援的系結延伸模組組合,請參閱 延伸模組套件組合發行頁面

在某些情況下,您無法使用擴充功能套件組合,例如當您需要使用特定擴充功能的特定發行前版本時。 在這些罕見的情況下,您必須在 C# 專案檔中手動安裝任何必要的系結延伸模組,以參考應用程式所需的特定延伸模組。 若要手動安裝系結延伸模組:

  1. 你的host.json 檔案中移除延伸套件組合的參考。

  2. 在 Azure Functions Core Tools 中使用 func extensions install 命令,在本機專案的根目錄中產生必要的 extensions.csproj 檔案。

    針對僅限入口網站的開發,您必須在 Azure 中函式應用程式的根目錄中手動建立 extensions.csproj 檔案。 若要深入了解,請參閱手動安裝延伸模組

  3. 編輯extensions.csproj檔案,明確新增應用程式所需的每個特定繫結擴充功能和版本的PackageReference元素。

  4. 在本機驗證您的應用程式功能,然後將專案,包括 extensions.csproj 重新部署至 Azure 中的函式應用程式。

您應該儘快 將應用程式切換回使用最新的支援延伸模組套件組合

下一步