你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
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# 项目文件中手动安装任何必需的绑定扩展。 手动安装绑定插件:
从 host.json 文件中删除扩展捆绑包引用。
使用 Azure Functions Core Tools 中的 func extensions install 命令在本地项目的根目录中生成所需的 extensions.csproj 文件。
对于仅限门户的开发,需要在 Azure 中函数应用的根目录中手动创建 extensions.csproj 文件。 若要了解详细信息,请参阅手动安装扩展。
编辑extensions.csproj文件时,显式为应用程序所需的每个特定绑定扩展和版本添加
PackageReference
元素。在本地验证应用功能,然后将项目(包括 extensions.csproj)重新部署到 Azure 中的函数应用。
应尽快 将应用切换回使用最新支持的扩展捆绑包。