Tag Helper Environnement dans ASP.NET Core

  • Article

Par Peter Kellner et Hisham Bin Ateya

Le Tag Helper Environnement affiche de façon conditionnelle son contenu joint en fonction de l’environnement d’hébergement actuel. L’attribut unique du Tag Helper Environnement, names, est une liste séparée par des virgules de noms d’environnement. Si l’un des noms d’environnement fournis correspond à l’environnement actuel, le contenu joint est affiché.

Pour obtenir une vue d’ensemble des Tag Helpers, consultez Tag Helpers dans ASP.NET Core.

Attributs de Tag Helper Environnement

noms

names accepte un seul nom d’environnement d’hébergement ou une liste séparée par des virgules de noms d’environnement d’hébergement qui déclenchent l’affichage du contenu joint.

Les valeurs d’environnement sont comparées à la valeur actuelle retournée par IWebHostEnvironment.EnvironmentName. La comparaison ignore la casse.

L’exemple suivant utilise un Tag Helper Environnement. Le contenu est affiché si l’environnement d’hébergement est un environnement de préproduction (Staging) ou de production :

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

Attributs include et exclude

Les attributs include et exclude contrôlent le rendu du contenu joint en fonction des noms d’environnement d’hébergement inclus ou exclus.

include

La propriété include présente un comportement similaire à l’attribut names. Un environnement listé dans la valeur d’attribut include doit correspondre à l’environnement d’hébergement de l’application (IWebHostEnvironment.EnvironmentName) pour afficher le contenu de la balise <environment>.

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

exclure

Contrairement à l’attribut include, le contenu de la balise <environment> est affiché quand l’environnement d’hébergement ne correspond pas à un environnement listé dans la valeur d’attribut exclude.

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

Ressources supplémentaires