Asistente de etiquetas de entorno en ASP.NET Core

  • Artículo

Por Peter Kellner y Hisham Bin Ateya

El asistente de etiquetas de entorno representa condicionalmente el 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 los asistentes de etiquetas, consulte 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

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

include

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

<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