通过

注册 Azure Functions 绑定扩展

  • 项目

从 Azure Functions 版本 2.x 开始，函数运行时默认情况下仅包括 HTTP 和计时器触发器。 其他触发器和绑定可作为单独的包提供。

.NET 类库函数应用使用以 NuGet 包的形式安装在项目中的绑定。 扩展捆绑包允许非 .NET 函数应用使用相同的绑定，而不必处理 .NET 基础结构。

下表指明了何时以及如何注册绑定。

开发环境 在
Functions 1.x 中注册		 在
Functions 2.x 或更高版本中注册
Azure 门户 自动 自动*
非 .NET 语言 自动 使用扩展捆绑（推荐）或显式安装扩展
使用 Visual Studio 的 C# 类库 使用 NuGet 工具 使用 NuGet 工具
使用 Visual Studio Code 的 C# 类库 不适用 使用 .NET Core CLI
使用 C# 开发工具包

* 门户使用扩展捆绑包，包括 C# 脚本。

扩展捆绑包

默认情况下，扩展捆绑包为以下语言的函数提供绑定支持：

  • Java
  • JavaScript
  • PowerShell
  • Python
  • C# 脚本
  • 其他（自定义处理程序）

在无法使用扩展捆绑包的极少数情况下，你可以使用函数应用项目显式安装绑定扩展。 2.x 版和更高版本的 Functions 运行时支持扩展捆绑包。

使用扩展捆绑包可将一组预定义的兼容绑定扩展添加到函数应用。 扩展捆绑已进行版本控制。 每个版本都包含一组特定的绑定扩展，这些扩展经过验证，可协同工作。 根据应用中所需的扩展，选择捆绑版本。

通过工具或在门户中创建非 .NET Functions 项目时，扩展包已在应用程序的 host.json 文件中启用。

扩展包引用由 host.json 中的 extensionBundle 节定义，如下所示：

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[3.3.0, 4.0.0)"
    }
}

extensionBundle 中提供了以下属性：

properties 说明
id Azure Functions 扩展捆绑的命名空间。
版本 要安装的捆绑包的版本。 Functions 运行时始终选取由版本范围或间隔定义的可允许最高版本。 上述版本值允许从 3.3.0 到（但不包括）4.0.0 的所有捆绑包版本。 有关详细信息，请参阅用于指定版本范围的间隔表示法。

下表列出了默认 Microsoft.Azure.Functions.ExtensionBundle 捆绑的当前可用版本范围以及它们所包括的扩展的链接。

捆绑版本 host.json 中的版本 已包含的扩展
1.x [1.*, 2.0.0) 请参阅用于生成捆绑的 extensions.json。
2.x [2.*, 3.0.0) 请参阅用于生成捆绑的 extensions.json。
3.x [3.3.0, 4.0.0) 请参阅用于生成捆绑的 extensions.json。
4.x [4.0.0, 5.0.0) 请参阅用于生成捆绑的 extensions.json。

注意

即使 host.json 支持 version 的自定义范围，你也应该使用此表中的版本范围值，例如 [4.0.0, 5.0.0)。 有关扩展捆绑包发行版以及每个发行版中的扩展版本的完整列表，请参阅扩展捆绑包发行版页面。

显式安装扩展

对于已编译的 C# 类库项目（进程内和独立工作进程），可以照常安装所需扩展的 NuGet 包。 有关示例，请参阅 Visual Studio Code 开发人员指南或 Visual Studio 开发人员指南。 请参阅扩展捆绑包发行版页面，查看已确认兼容的扩展版本组合。

对于非 .NET 语言和 C# 脚本，当无法使用扩展捆绑包时，则需要在本地项目中手动安装所需的绑定扩展。 最简单的方法是使用 Azure Functions Core Tools。 有关详细信息，请参阅 func extensions install。

对于仅限门户的开发，需要在函数应用的根目录中手动创建 extensions.csproj 文件。 若要了解详细信息，请参阅手动安装扩展。

后续步骤

Azure Functions 触发器和绑定示例