Asistente de etiquetas de entorno en ASP.NET Core

Por Peter Kellner y Hisham Bin Ateya

El asistente de etiquetas de entorno representa condicionalmente su contenido incluido en función del entorno de hospedaje actual. El único atributo del asistente de etiquetas de entorno, names, es una lista de nombres de entorno separados por comas. Si alguno de los nombres de entorno proporcionados coincide con el entorno actual, se representa el contenido incluido.

Para obtener información general sobre asistentes de etiquetas, vea Asistentes de etiquetas en ASP.NET Core.

Atributos del asistente de etiquetas de entorno

nombres

names acepta un solo nombre de entorno de hospedaje o una lista de nombres de entorno de hospedaje separados por comas que desencadenan la representación del contenido incluido.

Los valores de entorno se comparan con el valor actual devuelto por IWebHostEnvironment.EnvironmentName. La comparación ignora el uso de mayúsculas y minúsculas.

En este ejemplo se usa un asistente de etiquetas de entorno. El contenido se representa si el entorno de hospedaje es de almacenamiento provisional o de producción:

<environment names="Staging,Production">
    <strong>IWebHostEnvironment.EnvironmentName is Staging or Production</strong>
</environment>

Atributos include y exclude

includeLos atributos controlan la representación del contenido incluido en función de los nombres & exclude de entorno de hospedaje incluidos o excluidos.

include

La propiedad include exhibe un comportamiento similar al atributo names. Un entorno enumerado en el valor del atributo debe coincidir con el entorno de hospedaje de la aplicación include (IWebHostEnvironment.EnvironmentName) para representar el contenido de la <environment> etiqueta.

<environment include="Staging,Production">
    <strong>IWebHostEnvironment.EnvironmentName is Staging or Production</strong>
</environment>

exclude

A diferencia del atributo include, el contenido de la etiqueta <environment> se representa cuando el entorno de hospedaje no coincide con un entorno que se muestra en el valor de atributo exclude.

<environment exclude="Development">
    <strong>IWebHostEnvironment.EnvironmentName is not Development</strong>
</environment>

Recursos adicionales