Azure Functions kötésbővítmények regisztrálása

Az Azure Functions-futtatókörnyezet natív módon FUTTAT HTTP- és időzítő-eseményindítókat. A többi támogatott eseményindító és kötés viselkedését külön bővítménycsomagokban implementáljuk.

A .NET-osztálytár-projektek a projektben NuGet-csomagokként telepített kötésbővítményeket használnak.

A bővítménycsomagok lehetővé teszik, hogy non-.NET alkalmazások a .NET-infrastruktúrával való interakció nélkül használhassanak kötésbővítményeket.

Bővítménykötegek

A bővítménykötegek előre definiált kompatibilis kötésbővítményeket adnak hozzá a függvényalkalmazáshoz. A bővítménycsomagok verziószámozottak. Minden verzió tartalmaz egy bizonyos kötésbővítményeket, amelyek igazoltan működnek együtt. Válasszon ki egy csomagverziót az alkalmazásban szükséges bővítmények alapján.

Amikor azure Functions-projektet hoz létre egy non-.NET-sablonból, a bővítménycsomagok már engedélyezve vannak az alkalmazás host.json fájljában.

Ha lehetséges, használja a legújabb verziótartományt az optimális alkalmazásteljesítmény eléréséhez és a legújabb funkciókhoz való hozzáféréshez. A bővítménykötegekkel kapcsolatos további információkért tekintse meg az Azure Functions bővítménycsomagjait.

Abban a valószínűtlen esetben, ha nem tud bővítménycsomagot használni, inkább explicit módon kell telepítenie a bővítményeket.

Bővítmények explicit telepítése

A lefordított C#-osztálytár-projektekhez a szükséges bővítményekhez telepítenie kell a NuGet-csomagokat, ahogyan az alkalmazásokban általában tenné. További információkért tekintse meg a Visual Studio Code fejlesztői útmutatóját vagy a Visual Studio fejlesztői útmutatóját.

Ügyeljen arra, hogy a megfelelő csomagot szerezze be, mert a névtér a végrehajtási modelltől függően eltérő:

Végrehajtási modell	Namespace
Izolált munkafolyamat	Microsoft.Azure.Functions.Worker.Extensions.*
Folyamatban	Microsoft.Azure.WebJobs.Extensions.*

A Functions bővítménycsomagokat biztosít non-.NET projektekhez, amelyek a kompatibilisnek ellenőrzött kötésbővítmények teljes készletét tartalmazzák. Ha két vagy több kötésbővítmény között kompatibilitási problémákat tapasztal, tekintse át a bővítményverziók kompatibilis kombinációit. A kötésbővítmények támogatott kombinációiért tekintse meg a bővítménycsomagok kiadási oldalát.

Vannak olyan esetek, amikor nem használhat bővítménycsomagokat, például amikor egy adott bővítmény adott előzetes verzióját kell használnia. Ezekben a ritka esetekben manuálisan kell telepítenie a szükséges kötésbővítményeket egy C#-projektfájlba, amely az alkalmazás által igényelt adott bővítményekre hivatkozik. Kötésbővítmények manuális telepítése:

1. Távolítsa el a bővítménycsomag referenciáját a host.json fájlból.

2. Az Azure Functions Core Tools func extensions install parancsával hozza létre a szükséges extensions.csproj fájlt a helyi projekt gyökerében.

   A csak portálos fejlesztéshez manuálisan kell létrehoznia egy extensions.csproj fájlt a függvényalkalmazás gyökerében az Azure-ban. További információ: Bővítmények manuális telepítése.

3. Szerkessze a extensions.csproj fájlt úgy, hogy explicit módon hozzáad egy PackageReference elemet az alkalmazás által igényelt összes kötéskiterjesztéshez és verzióhoz.

4. Ellenőrizze az alkalmazás funkcióit helyileg, majd helyezze újra üzembe a projektet, beleértve a extensions.csproj fájlt is az Azure-beli függvényalkalmazásban.

A lehető leghamarabb állítsa vissza az alkalmazást a legújabb támogatott bővítménycsomag használatára.

Következő lépések

Azure-függvény eseményindítója és kötési példája