Azure Functions kötési bővítmények regisztrálásaRegister Azure Functions binding extensions

Azure Functions 2. x verziójában a kötések külön csomagokként érhetők el a functions futtatókörnyezetből.In Azure Functions version 2.x, bindings are available as separate packages from the functions runtime. Míg a .NET függvények NuGet-csomagokon keresztül érik el a kötéseket, a bővítmények lehetővé teszik más függvények számára, hogy a konfigurációs beállításokon keresztül hozzáférjenek az összes kötéshez.While .NET functions access bindings through NuGet packages, extension bundles allow other functions access to all bindings through a configuration setting.

Vegye figyelembe a kötési bővítményekkel kapcsolatos következő elemeket:Consider the following items related to binding extensions:

A következő táblázat azt mutatja be, hogy mikor és hogyan regisztrálja a kötéseket.The following table indicates when and how you register bindings.

Fejlesztési környezetDevelopment environment RegisztrációRegistration
a functions 1. xin Functions 1.x
RegisztrációRegistration
a functions 2. xin Functions 2.x
Azure PortalAzure portal AutomatikusAutomatic AutomatikusAutomatic
Non-.NET-nyelvek vagy helyi Azure Core-eszközök fejlesztéseNon-.NET languages or local Azure Core Tools development AutomatikusAutomatic Azure Functions Core Tools-és bővítmény-csomagok használataUse Azure Functions Core Tools and extension bundles
C#osztály könyvtára a Visual StudióvalC# class library using Visual Studio NuGet-eszközök használataUse NuGet tools NuGet-eszközök használataUse NuGet tools
C#a Visual Studio Code-ot használó osztály könyvtáraC# class library using Visual Studio Code N/A A .NET Core parancssori felülete használataUse .NET Core CLI

Kiterjesztési csomagok helyi fejlesztéshezExtension bundles for local development

A bővítmények a 2. x verzió helyi fejlesztési technológiája, amely lehetővé teszi, hogy a Function app-projekthez hozzáadjon egy kompatibilis függvények kötési bővítményeket.Extension bundles is a local development technology for the version 2.x runtime that lets you add a compatible set of Functions binding extensions to your function app project. Ezeket a kiterjesztési csomagokat a rendszer az Azure-ba történő üzembe helyezéskor felveszi a központi telepítési csomagba.These extension packages are then included in the deployment package when you deploy to Azure. A csomagok a Microsoft által közzétett összes kötést a Host. JSON fájl egy beállításával teszik elérhetővé.Bundles makes all bindings published by Microsoft available through a setting in the host.json file. A csomagban definiált kiterjesztési csomagok kompatibilisek egymással, ami segít elkerülni a csomagok közötti ütközéseket.Extension packages defined in a bundle are compatible with each other, which helps you avoid conflicts between packages. Helyi fejlesztés esetén győződjön meg arról, hogy a Azure functions Core Toolslegújabb verzióját használja.When developing locally, make sure you are using the latest version of Azure Functions Core Tools.

Az Azure Functions Core Tools vagy a Visual Studio Code használatával minden helyi fejlesztéshez használhat bővítmény-csomagokat.Use extension bundles for all local development using Azure Functions Core Tools or Visual Studio Code.

Ha nem használ bővítmény-csomagokat, a kötési bővítmények telepítése előtt telepítenie kell a .NET Core 2. x SDK-t a helyi számítógépen.If you don't use extension bundles, you must install the .NET Core 2.x SDK on your local computer before you install any binding extensions. A csomagok ezt a követelményt a helyi fejlesztéshez is megszüntetik.Bundles removes this requirement for local development.

A bővítmények használatához frissítse a Host. JSON fájlt, hogy tartalmazza a következő bejegyzést extensionBundle:To use extension bundles, update the host.json file to include the following entry for extensionBundle:

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[1.*, 2.0.0)"
    }
}

A következő tulajdonságok érhetők el a extensionBundleben:The following properties are available in extensionBundle:

TulajdonságProperty LeírásDescription
id Microsoft Azure functions bővítmények névterei.The namespace for Microsoft Azure Functions extension bundles.
version A telepítendő csomag verziószáma.The version of the bundle to install. A functions Runtime mindig kiválasztja a verziószám vagy az intervallum által meghatározott maximálisan megengedett verziót.The Functions runtime always picks the maximum permissible version defined by the version range or interval. A fenti verzió értéke lehetővé teszi, hogy az összes köteg verziója a 1.0.0-ból, de nem tartalmazza a 2.0.0.The version value above allows all bundle versions from 1.0.0 up to but not including 2.0.0. További információ: a verziók tartományának megadására szolgáló intervallum jelölése.For more information, see the interval notation for specifying version ranges.

A csomag verziójának növekménye csomagokként a köteg változása.Bundle versions increment as packages in the bundle change. A főverzió módosításai akkor fordulnak elő, ha a csomagban lévő csomagok nagyobb verziójúak, ami általában egybeesik a functions futtatókörnyezet főverziójának változásával.Major version changes occur when packages in the bundle increment by a major version, which usually coincides with a change in the major version of the Functions runtime.

Az alapértelmezett csomag által telepített bővítmények jelenleg a Extensions. JSON fájlbanvannak felsorolva.The current set of extensions installed by the default bundle are enumerated in this extensions.json file.

C# osztályú könyvtár a Visual StudióvalC# class library with Visual Studio

A Visual Studióbana Package Manager konzolon telepítheti a csomagokat az Install-Package paranccsal, ahogy az alábbi példában is látható:In Visual Studio, you can install packages from the Package Manager Console using the Install-Package command, as shown in the following example:

Install-Package Microsoft.Azure.WebJobs.Extensions.ServiceBus -Version <TARGET_VERSION>

Az adott kötéshez használt csomag neve az adott kötéshez tartozó hivatkozási cikkben található.The name of the package used for a given binding is provided in the reference article for that binding. Példaként tekintse meg a Service Bus kötési útmutató csomagok szakaszát.For an example, see the Packages section of the Service Bus binding reference article.

Cserélje <TARGET_VERSION> le a példát a csomag egy adott verziójára, 3.0.0-beta5például:.Replace <TARGET_VERSION> in the example with a specific version of the package, such as 3.0.0-beta5. Az érvényes verziók a NuGet.org-on található egyedi csomag oldalain találhatók. Az 1. x vagy 2. x függvényeknek megfelelő főverziók a kötésre vonatkozó hivatkozási cikkben vannak megadva.Valid versions are listed on the individual package pages at NuGet.org. The major versions that correspond to Functions runtime 1.x or 2.x are specified in the reference article for the binding.

Ha egy kötésre mutató hivatkozást használ Install-Package , nem szükséges a bővítményekhasználata.If you use Install-Package to reference a binding, you do not need to use extension bundles. Ez a megközelítés kifejezetten a Visual Studióban létrehozott osztályok könyvtáraira vonatkozik.This approach is specific for class libraries built in Visual Studio.

C# osztály könyvtára a Visual Studio Code-banC# class library with Visual Studio Code

Megjegyzés

Javasoljuk, hogy a bővítmények használatával a függvények automatikusan telepítsék a kötési bővítmények kompatibilis készletét.We recommend using extension bundles to have Functions automatically install a compatible set of binding extension packages.

A Visual Studio Code-ban a parancssorban C# telepítsen egy Class Library-projekthez tartozó csomagokat a a .net Core parancssori felülete.In Visual Studio Code, install packages for a C# class library project from the command prompt using the dotnet add package command in the .NET Core CLI. Az alábbi példa bemutatja, hogyan adhat hozzá kötéseket:The following example demonstrates how you add a binding:

dotnet add package Microsoft.Azure.WebJobs.Extensions.<BINDING_TYPE_NAME> --version <TARGET_VERSION>

A a .NET Core parancssori felülete csak Azure Functions 2. x fejlesztéshez használható.The .NET Core CLI can only be used for Azure Functions 2.x development.

Cserélje <BINDING_TYPE_NAME> le a (z) helyére a kívánt kötésre vonatkozó hivatkozási cikkben megadott csomag nevét.Replace <BINDING_TYPE_NAME> with the name of the package provided in the reference article for your desired binding. A kívánt kötési hivatkozásról szóló cikket a támogatott kötések listájábantalálja.You can find the desired binding reference article in the list of supported bindings.

Cserélje <TARGET_VERSION> le a példát a csomag egy adott verziójára, 3.0.0-beta5például:.Replace <TARGET_VERSION> in the example with a specific version of the package, such as 3.0.0-beta5. Az érvényes verziók a NuGet.org-on található egyedi csomag oldalain találhatók. Az 1. x vagy 2. x függvényeknek megfelelő főverziók a kötésre vonatkozó hivatkozási cikkben vannak megadva.Valid versions are listed on the individual package pages at NuGet.org. The major versions that correspond to Functions runtime 1.x or 2.x are specified in the reference article for the binding.

További lépésekNext steps