Registrar las extensiones de enlace de Azure FunctionsRegister Azure Functions binding extensions

En la versión de Azure Functions 2.x, enlaces están disponibles como paquetes independientes del tiempo de ejecución de funciones.In Azure Functions version 2.x, bindings are available as separate packages from the functions runtime. Mientras que las funciones de .NET tener acceso a los enlaces a través de paquetes de NuGet, paquetes de extensión permiten el acceso de otras funciones a todos los enlaces a través de un valor de configuración.While .NET functions access bindings through NuGet packages, extension bundles allow other functions access to all bindings through a configuration setting.

Tenga en cuenta los siguientes elementos relacionados con extensiones de enlace:Consider the following items related to binding extensions:

En la tabla siguiente indica cómo y cuándo registrar los enlaces.The following table indicates when and how you register bindings.

Entorno de desarrolloDevelopment environment RegistroRegistration
en Functions 1.xin Functions 1.x
RegistroRegistration
en Functions 2.xin Functions 2.x
Azure PortalAzure portal AutomáticoAutomatic AutomáticoAutomatic
Lenguajes que no sean de. NET o desarrollo de herramientas de Azure Core localNon-.NET languages or local Azure Core Tools development AutomáticoAutomatic Use Azure Functions Core Tools y agrupaciones de extensiónUse Azure Functions Core Tools and extension bundles
C#biblioteca de clases mediante Visual Studio de 2019C# class library using Visual Studio 2019 Uso de herramientas NuGetUse NuGet tools Uso de herramientas NuGetUse NuGet tools
Biblioteca de clases de C# con Visual Studio CodeC# class library using Visual Studio Code N/DN/A Uso de la CLI de .NET CoreUse .NET Core CLI

Desarrollo local con Azure Functions Core Tools y agrupaciones de extensiónLocal development with Azure Functions Core Tools and extension bundles

Paquetes de extensión realizar todos los enlaces publicados por el equipo de Azure Functions disponible a través de una configuración en el host.json archivo.Extension bundles make all bindings published by the Azure Functions team available through a setting in the host.json file. Para el desarrollo local, asegúrese de que tiene la versión más reciente de Azure Functions Core Tools.For local development, ensure you have the latest version of Azure Functions Core Tools.

Para usar paquetes de extensión, actualice el host.json archivo para incluir la siguiente entrada para extensionBundle: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)"
    }
}
  • El id propiedad hace referencia el espacio de nombres de los paquetes de extensión de Microsoft Azure Functions.The id property references the namespace for Microsoft Azure Functions extension bundles.
  • El version hace referencia a la versión de la agrupación.The version references the version of the bundle.

Incremento de las versiones de agrupación como paquetes en los cambios del lote.Bundle versions increment as packages in the bundle changes. Cambios de versión principal realizan solo cuando mueve los paquetes en el paquete de una versión principal.Major version changes happen only when packages in the bundle move a major version. El version propiedad usa el notación de intervalo para especificar intervalos de versiones.The version property uses the interval notation for specifying version ranges. El tiempo de ejecución de Functions siempre elige la versión permitida máxima definida por el intervalo de versiones o el intervalo.The Functions runtime always picks the maximum permissible version defined by the version range or interval.

Una vez que se hace referencia a los paquetes de extensión en el proyecto, a continuación, todos los enlaces predeterminados están disponibles para las funciones.Once you reference the extension bundles in your project, then all default bindings are available to your functions. Los enlaces disponibles en el conjunto de extensiones son:The bindings available in the extension bundle are:

PaquetePackage VersionVersion
Microsoft.Azure.WebJobs.Extensions.CosmosDBMicrosoft.Azure.WebJobs.Extensions.CosmosDB 3.0.33.0.3
Microsoft.Azure.WebJobs.Extensions.DurableTaskMicrosoft.Azure.WebJobs.Extensions.DurableTask 1.8.01.8.0
Microsoft.Azure.WebJobs.Extensions.EventGridMicrosoft.Azure.WebJobs.Extensions.EventGrid 2.0.02.0.0
Microsoft.Azure.WebJobs.Extensions.EventHubsMicrosoft.Azure.WebJobs.Extensions.EventHubs 3.0.33.0.3
Microsoft.Azure.WebJobs.Extensions.SendGridMicrosoft.Azure.WebJobs.Extensions.SendGrid 3.0.03.0.0
Microsoft.Azure.WebJobs.Extensions.ServiceBusMicrosoft.Azure.WebJobs.Extensions.ServiceBus 3.0.33.0.3
Microsoft.Azure.WebJobs.Extensions.SignalRServiceMicrosoft.Azure.WebJobs.Extensions.SignalRService 1.0.01.0.0
Microsoft.Azure.WebJobs.Extensions.StorageMicrosoft.Azure.WebJobs.Extensions.Storage 3.0.43.0.4
Microsoft.Azure.WebJobs.Extensions.TwilioMicrosoft.Azure.WebJobs.Extensions.Twilio 3.0.03.0.0

C#biblioteca de clases con Visual Studio de 2019C# class library with Visual Studio 2019

En 2019 de Visual Studio, puede instalar paquetes desde la consola de administrador de paquetes con el Install-Package de comandos, tal como se muestra en el ejemplo siguiente:In Visual Studio 2019, 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>

Se proporciona el nombre del paquete que se usa para un enlace determinado en el artículo de referencia para ese objeto binding.The name of the package used for a given binding is provided in the reference article for that binding. Para obtener un ejemplo, consulte la sección de paquetes del artículo de referencia de enlace de Service Bus.For an example, see the Packages section of the Service Bus binding reference article.

Reemplace <TARGET_VERSION> en el ejemplo con una versión específica del paquete, como 3.0.0-beta5.Replace <TARGET_VERSION> in the example with a specific version of the package, such as 3.0.0-beta5. Las versiones válidas se enumeran en las páginas individuales del paquete en NuGet.org. Las versiones principales que corresponden al tiempo de ejecución de Functions 1.x o 2.x se especifican en el artículo de referencia del enlace.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.

Biblioteca de clases de C# con Visual Studio CodeC# class library with Visual Studio Code

En Visual Studio Code, puede instalar paquetes desde el símbolo de sistema mediante el comando dotnet add package de la CLI de .NET Core, tal como se muestra en el ejemplo siguiente:In Visual Studio Code, you can install packages from the command prompt using the dotnet add package command in the .NET Core CLI, as shown in the following example:

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

La CLI de .NET Core solo puede utilizarse para el desarrollo de Azure Functions 2.x.The .NET Core CLI can only be used for Azure Functions 2.x development.

El nombre del paquete que se usará para un enlace determinado se proporciona en el artículo de referencia de ese enlace.The name of the package to use for a given binding is provided in the reference article for that binding. Para obtener un ejemplo, consulte la sección de paquetes del artículo de referencia de enlace de Service Bus.For an example, see the Packages section of the Service Bus binding reference article.

Reemplace <TARGET_VERSION> en el ejemplo con una versión específica del paquete, como 3.0.0-beta5.Replace <TARGET_VERSION> in the example with a specific version of the package, such as 3.0.0-beta5. Las versiones válidas se enumeran en las páginas individuales del paquete en NuGet.org. Las versiones principales que corresponden al tiempo de ejecución de Functions 1.x o 2.x se especifican en el artículo de referencia del enlace.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.

Pasos siguientesNext steps