Registrare le estensioni di binding di funzioni di AzureRegister Azure Functions binding extensions

In funzioni di Azure versione 2. x, le associazioni sono disponibili come pacchetti distinti dal runtime di funzioni.In Azure Functions version 2.x, bindings are available as separate packages from the functions runtime. Mentre le funzioni .NET accedono ai binding tramite pacchetti NuGet, i bundle di estensione consentono ad altre funzioni di accedere a tutte le associazioni tramite un'impostazione di configurazione.While .NET functions access bindings through NuGet packages, extension bundles allow other functions access to all bindings through a configuration setting.

Considerare i seguenti elementi correlati alle estensioni di binding:Consider the following items related to binding extensions:

La tabella seguente indica quando e come registrare le associazioni.The following table indicates when and how you register bindings.

Ambiente di sviluppoDevelopment environment RegistrazioneRegistration
in Funzioni 1.xin Functions 1.x
RegistrazioneRegistration
in Funzioni 2.xin Functions 2.x
Portale di AzureAzure portal AutomaticoAutomatic AutomaticoAutomatic
Lingue Non-.NET o sviluppo locale di strumenti di Azure CoreNon-.NET languages or local Azure Core Tools development AutomaticoAutomatic Usare i bundle di Azure Functions Core Tools ed estensioneUse Azure Functions Core Tools and extension bundles
C#libreria di classi con Visual StudioC# class library using Visual Studio Usare gli strumenti di NuGetUse NuGet tools Usare gli strumenti di NuGetUse NuGet tools
Libreria di classi C# usando Visual Studio CodeC# class library using Visual Studio Code N/DN/A Usare l'interfaccia della riga di comando di .NET CoreUse .NET Core CLI

Bundle di estensione per lo sviluppo localeExtension bundles for local development

Bundle di estensione è una tecnologia di sviluppo locale per il runtime della versione 2. x che consente di aggiungere un set compatibile di estensioni di associazione di funzioni al progetto dell'app per le funzioni.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. Questi pacchetti di estensione vengono quindi inclusi nel pacchetto di distribuzione quando si esegue la distribuzione in Azure.These extension packages are then included in the deployment package when you deploy to Azure. Bundle rende disponibili tutte le associazioni pubblicate da Microsoft tramite un'impostazione nel file host. JSON .Bundles makes all bindings published by Microsoft available through a setting in the host.json file. I pacchetti di estensione definiti in un bundle sono compatibili tra loro, consentendo di evitare conflitti tra i pacchetti.Extension packages defined in a bundle are compatible with each other, which helps you avoid conflicts between packages. Quando si sviluppa localmente, assicurarsi di usare la versione più recente di Azure Functions Core Tools.When developing locally, make sure you are using the latest version of Azure Functions Core Tools.

Usare i bundle di estensione per lo sviluppo locale usando Azure Functions Core Tools o Visual Studio Code.Use extension bundles for all local development using Azure Functions Core Tools or Visual Studio Code.

Se non si usano i bundle di estensione, è necessario installare .NET Core 2. x SDK nel computer locale prima di installare le estensioni di binding.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. Bundles rimuove questo requisito per lo sviluppo locale.Bundles removes this requirement for local development.

Per usare i bundle di estensione, aggiornare il file host. JSON in modo da includere la extensionBundlevoce seguente per: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)"
    }
}

In extensionBundlesono disponibili le proprietà seguenti:The following properties are available in extensionBundle:

ProprietàProperty DESCRIZIONEDescription
id Spazio dei nomi per i bundle di estensioni di funzioni Microsoft Azure.The namespace for Microsoft Azure Functions extension bundles.
version Versione del bundle da installare.The version of the bundle to install. Il runtime di funzioni sceglie sempre la versione massima consentita definita dall'intervallo o dall'intervallo di versioni.The Functions runtime always picks the maximum permissible version defined by the version range or interval. Il valore della versione precedente consente a tutte le versioni del bundle da 1.0.0 fino a, ma non incluso 2.0.0.The version value above allows all bundle versions from 1.0.0 up to but not including 2.0.0. Per ulteriori informazioni, vedere la notazione intervallo per specificare gli intervalli di versione.For more information, see the interval notation for specifying version ranges.

Le versioni del bundle vengono incrementate come pacchetti nella modifica del bundle.Bundle versions increment as packages in the bundle change. Le modifiche alla versione principale si verificano quando i pacchetti nel bundle vengono incrementati di una versione principale, che in genere coincide con una modifica nella versione principale del runtime di funzioni.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.

Il set corrente di estensioni installate dal bundle predefinito viene enumerato in questo file Extensions. JSON.The current set of extensions installed by the default bundle are enumerated in this extensions.json file.

Libreria# di classi C con Visual StudioC# class library with Visual Studio

In Visual Studioè possibile installare i pacchetti dalla console di gestione pacchetti usando il comando Install-Package , come illustrato nell'esempio seguente: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>

Il nome del pacchetto utilizzato per una determinata associazione viene fornito nell'articolo di riferimento per l'associazione.The name of the package used for a given binding is provided in the reference article for that binding. Per un esempio, vedere la sezione sui pacchetti dell'articolo di riferimento sull'associazione del bus di servizio.For an example, see the Packages section of the Service Bus binding reference article.

Sostituire <TARGET_VERSION> nell'esempio con una specifica versione del pacchetto, come 3.0.0-beta5.Replace <TARGET_VERSION> in the example with a specific version of the package, such as 3.0.0-beta5. Le versioni valide sono elencate nelle pagine dei singoli pacchetti in NuGet.org. Le versioni principali che corrispondono al runtime di Funzioni 1.x o 2.x sono specificate nell'articolo di riferimento per l'associazione.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.

Se si utilizza Install-Package per fare riferimento a un'associazione, non è necessario utilizzare i bundle di estensione.If you use Install-Package to reference a binding, you do not need to use extension bundles. Questo approccio è specifico per le librerie di classi compilate in Visual Studio.This approach is specific for class libraries built in Visual Studio.

C# libreria di classi con Visual Studio CodeC# class library with Visual Studio Code

Nota

Si consiglia di usare bundle di estensione per installare automaticamente un set compatibile di pacchetti di estensioni di binding.We recommend using extension bundles to have Functions automatically install a compatible set of binding extension packages.

In Visual Studio Code, installare i pacchetti per C# un progetto di libreria di classi dal prompt dei comandi usando il comando DotNet Add Package nel interfaccia della riga di comando di .NET Core.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. Nell'esempio seguente viene illustrato come aggiungere un'associazione:The following example demonstrates how you add a binding:

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

L'interfaccia della riga di comando di .NET Core può essere usata solo per lo sviluppo di Funzioni di Azure 2.x.The .NET Core CLI can only be used for Azure Functions 2.x development.

Sostituire <BINDING_TYPE_NAME> con il nome del pacchetto fornito nell'articolo di riferimento per l'associazione desiderata.Replace <BINDING_TYPE_NAME> with the name of the package provided in the reference article for your desired binding. È possibile trovare l'articolo di riferimento per l'associazione desiderato nell' elenco di associazioni supportate.You can find the desired binding reference article in the list of supported bindings.

Sostituire <TARGET_VERSION> nell'esempio con una specifica versione del pacchetto, come 3.0.0-beta5.Replace <TARGET_VERSION> in the example with a specific version of the package, such as 3.0.0-beta5. Le versioni valide sono elencate nelle pagine dei singoli pacchetti in NuGet.org. Le versioni principali che corrispondono al runtime di Funzioni 1.x o 2.x sono specificate nell'articolo di riferimento per l'associazione.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.

Passaggi successiviNext steps