Registrera Azure Functions bindningstillägg

Från och med Azure Functions version 2.x innehåller funktionskörningen endast HTTP- och timerutlösare som standard. Andra utlösare och bindningar är tillgängliga som separata paket.

I .NET-klassbiblioteksfunktioner används bindningar som är installerade i projektet som NuGet-paket. Med tilläggspaket kan non-.NET functions-appar använda samma bindningar utan att behöva hantera .NET-infrastrukturen.

I följande tabell visas när och hur du registrerar bindningar.

Utvecklingsmiljö Registrering
i Functions 1.x
Registrering
i Functions 2.x eller senare
Azure Portal Automatiskt Automatisk*
Non-.NET språk Automatiskt Använda tilläggspaket (rekommenderas) eller uttryckligen installera tillägg
C#-klassbibliotek med Visual Studio Använda NuGet-verktyg Använda NuGet-verktyg
C#-klassbibliotek med Visual Studio Code Ej tillämpligt Använda .NET Core CLI

* Portalen använder tilläggspaket, inklusive C#-skript.

Tilläggspaket

Som standard används tilläggspaket av Java-, JavaScript-, PowerShell-, Python-, C#-skript- och Custom Handler-funktionsappar för att fungera med bindningstillägg. I de fall där tilläggspaket inte kan användas kan du uttryckligen installera bindningstillägg med ditt funktionsappsprojekt. Tilläggspaket stöds för version 2.x och senare version av Functions-körningen.

Tilläggspaket är ett sätt att lägga 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 non-.NET Functions-projekt från verktyg eller i portalen är tilläggspaket redan aktiverade i appens host.json-fil .

En referens för tilläggspaket definieras av extensionBundle avsnittet i en host.json enligt följande:

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

Följande egenskaper är tillgängliga i extensionBundle:

Egenskap Beskrivning
id Namnområdet för Tilläggspaket för Microsoft Azure Functions.
version Den version av paketet som ska installeras. Functions-körningen väljer alltid den högsta tillåtna versionen som definieras av versionsintervallet eller intervallet. Versionsvärdet ovan tillåter alla paketversioner från 3.3.0 upp till men inte 4.0.0. Mer information finns i intervallnotationen för att ange versionsintervall.

I följande tabell visas de tillgängliga versionerna av standardpaketet Microsoft.Azure.Functions.ExtensionBundle och länkar till de tillägg som de innehåller.

Paketversion Version i host.json Inkluderade tillägg
1.x [1.*, 2.0.0) Se extensions.json som används för att generera paketet
2.x [2.*, 3.0.0) Se extensions.json som används för att generera paketet
3.x [3.3.0, 4.0.0) Se extensions.json som används för att generera paketet1

1 Version 3.x av tilläggspaketet innehåller för närvarande inte Table Storage-bindningar. Om din app kräver Table Storage måste du fortsätta att använda 2.x-versionen för tillfället.

Anteckning

Även om host.json stöder anpassade intervall för versionbör du använda ett versionsvärde från den här tabellen.

Installera tillägg uttryckligen

För kompilerade C#-klassbiblioteksprojekt (processbaserad och isolerad arbetsprocess) installerar du NuGet-paketen för de tillägg som du behöver som vanligt. Exempel finns i utvecklarguiden för Visual Studio Code eller i utvecklarhandboken för Visual Studio.

För non-.NET språk och C#-skript måste du installera nödvändiga bindningstillägg manuellt i det lokala projektet när du inte kan använda tilläggspaket. Det enklaste sättet är att använda Azure Functions Core Tools. Mer information finns i Installera tillägg.

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

Nästa steg