Azure Functions-bindingsextensies registreren

Projecten die gebruikmaken van een .NET-klassebibliotheek maken gebruik van bindingsextensies die in het project zijn geïnstalleerd als NuGet-pakketten.

Met extensiebundels kunnen non-.NET apps bindingsextensies gebruiken zonder dat ze hoeven te communiceren met de .NET-infrastructuur.

Extension bundles

Uitbreidingsbundels voegen een vooraf gedefinieerde set compatibele bindingsextensies toe aan uw functie-app. Uitbreidingsbundels zijn versiebeheer. Elke versie bevat een specifieke set bindingsextensies die zijn geverifieerd om samen te werken. Selecteer een bundelversie op basis van de extensies die u nodig hebt in uw app.

Wanneer u een Azure Functions-project maakt op basis van een non-.NET-sjabloon, zijn extensiebundels al ingeschakeld in het bestand van host.json de app.

Gebruik indien mogelijk het nieuwste versiebereik om optimale app-prestaties en toegang tot de nieuwste functies te verkrijgen. Zie Azure Functions-extensiebundels voor meer informatie over uitbreidingsbundels.

In het onwaarschijnlijke geval dat u geen uitbreidingsbundel kunt gebruiken, moet u in plaats daarvan expliciet extensies installeren.

Voor projecten die gebruikmaken van een gecompileerde C#-klassebibliotheek installeert u de NuGet-pakketten voor de extensies die u nodig hebt zoals u normaal in uw apps zou doen. Zie de ontwikkelaarshandleiding voor Visual Studio Code of de ontwikkelaarshandleiding voor Visual Studio voor meer informatie.

Zorg ervoor dat u het juiste pakket verkrijgt, omdat de naamruimte verschilt, afhankelijk van het uitvoeringsmodel:

Azure Functions biedt uitbreidingsbundels voor non-.NET projecten. Deze bundels bevatten een volledige set bindingsextensies die zijn geverifieerd om compatibel te zijn. Als u compatibiliteitsproblemen ondervindt tussen twee of meer bindingsextensies, controleert u compatibele combinaties van extensieversies. Zie de releasepagina voor extensiebundels voor ondersteunde combinaties van bindingsextensies.

Er zijn gevallen waarin u geen uitbreidingsbundels kunt gebruiken, bijvoorbeeld wanneer u een specifieke voorlopige versie van een specifieke extensie moet gebruiken. In deze zeldzame gevallen moet u alle vereiste bindingsextensies handmatig installeren in een C#-projectbestand dat verwijst naar de specifieke extensies die uw app nodig heeft.

Bindingsextensies handmatig installeren:

1. Verwijder de extensiebundelverwijzing uit uw host.json bestand.

2. Gebruik de func extensions install opdracht in Azure Functions Core Tools om het vereiste extensions.csproj bestand te genereren in de hoofdmap van uw lokale project.

   Voor alleen-portalontwikkeling moet u handmatig een extensions.csproj bestand maken in de hoofdmap van uw functie-app in Azure. Zie Extensies handmatig installeren voor meer informatie.

3. Bewerk het extensions.csproj bestand door expliciet een PackageReference element toe te voegen voor elke specifieke bindingsextensie en versie die uw app nodig heeft.

4. Valideer uw app-functionaliteit lokaal en implementeer vervolgens uw project opnieuw, inclusief extensions.csproj, naar uw functie-app in Azure.

Zo snel mogelijk moet u uw app weer overschakelen naar het gebruik van de meest recente ondersteunde extensiebundel.