Registrera Azure Functions-bindningstillägg

Projekt som använder ett .NET-klassbibliotek använder bindningstillägg som är installerade i projektet som NuGet-paket.

Med tilläggspaket kan non-.NET appar använda bindningstillägg utan att behöva interagera med .NET-infrastrukturen.

Extension bundles

Tilläggspaket lägger till en fördefinierad uppsättning kompatibla bindningstillägg i funktionsappen. Tilläggspaket är versionshanterade. Varje version innehåller en specifik uppsättning bindningstillägg som har verifierats för att fungera tillsammans. Välj en paketversion baserat på de tillägg som du behöver i din app.

När du skapar ett Azure Functions-projekt från en non-.NET mall är tilläggspaket redan aktiverade i appens host.json fil.

Använd när det är möjligt det senaste versionsintervallet för att få optimal appprestanda och åtkomst till de senaste funktionerna. Mer information om tilläggspaket finns i Azure Functions-tilläggspaket.

Om det är osannolikt att du inte kan använda ett tilläggspaket måste du i stället uttryckligen installera tillägg.

För projekt som använder ett kompilerat C#-klassbibliotek installerar du NuGet-paketen för de tillägg som du behöver som vanligt i dina appar. Mer information finns i utvecklarguiden för Visual Studio Code eller Visual Studio-utvecklarguiden.

Se till att hämta rätt paket eftersom namnområdet skiljer sig beroende på körningsmodellen:

Azure Functions tillhandahåller tilläggspaket för non-.NET projekt. Dessa paket innehåller en fullständig uppsättning bindningstillägg som har verifierats vara kompatibla. Om du har kompatibilitetsproblem mellan två eller flera bindningstillägg granskar du kompatibla kombinationer av tilläggsversioner. För kombinationer av bindningstillägg som stöds, se versionssidan för tilläggspaket.

Det finns fall då du inte kan använda tilläggspaket, till exempel när du behöver använda en specifik förhandsversion av ett specifikt tillägg. I dessa sällsynta fall måste du manuellt installera nödvändiga bindningstillägg i en C#-projektfil som refererar till de specifika tillägg som din app kräver.

Så här installerar du bindningstillägg manuellt:

1. Ta bort tilläggspaketreferensen från host.json filen.

2. func extensions install Använd kommandot i Azure Functions Core Tools för att generera den nödvändiga extensions.csproj filen i roten för ditt lokala projekt.

   För utveckling endast för portalen måste du manuellt skapa en extensions.csproj fil i roten för funktionsappen i Azure. Mer information finns i Installera tillägg manuellt.

3. extensions.csproj Redigera filen genom att uttryckligen lägga till ett PackageReference element för varje specifikt bindningstillägg och version som din app kräver.

4. Verifiera appfunktionerna lokalt och distribuera sedan om projektet, inklusive extensions.csproj, till funktionsappen i Azure.

Så snart som möjligt bör du byta tillbaka appen till att använda det senaste tilläggspaketet som stöds.