Helper tag di ambiente in ASP.NET Core

  • Articolo

Di Peter Kellner e Hisham Bin Ateya

L'helper tag di ambiente esegue il rendering condizionale del proprio contenuto in base all'ambiente host corrente. L'unico attributo dell'helper tag di ambiente, names, è un elenco delimitato da virgole di nomi di ambiente. Se nessuno dei nomi di ambiente specificato corrisponde all'ambiente corrente, viene eseguito il rendering del contenuto incluso.

Per una panoramica degli helper tag, vedere Helper tag in ASP.NET Core.

Attributi dell'helper tag di ambiente

nomi

names accetta un singolo nome di ambiente host o un elenco delimitato da virgole di nomi di ambiente, che attiva il rendering del contenuto.

I valori di ambiente vengono confrontati con il valore corrente restituito da IWebHostEnvironment.EnvironmentName. Il confronto non applica la distinzione tra maiuscole e minuscole.

L'esempio seguente usa un helper tag di ambiente. Il rendering del contenuto viene eseguito se l'ambiente host è Staging o Production:

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

Attributi include ed exclude

include & exclude attributi controllano il rendering del contenuto racchiuso in base ai nomi di ambiente host inclusi o esclusi.

include

La proprietà include ha un comportamento simile all'attributo names. Un ambiente elencato nel valore dell'attributo include deve corrispondere all'ambiente di hosting dell'app (IWebHostEnvironment.EnvironmentName) per eseguire il rendering del contenuto del <environment> tag.

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

escludere

Al contrario dell'attributo include, il rendering del contenuto del tag <environment> viene eseguito quando l'ambiente host non corrisponde a un ambiente elencato nel valore dell'attributo exclude.

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

Risorse aggiuntive