Helper tag di ambiente in ASP.NET CoreEnvironment Tag Helper in ASP.NET Core

Di Peter Kellner, Hisham Bin Ateya e Luke LathamBy Peter Kellner, Hisham Bin Ateya, and Luke Latham

L'helper tag di ambiente esegue il rendering condizionale del proprio contenuto in base all'ambiente host corrente.The Environment Tag Helper conditionally renders its enclosed content based on the current hosting environment. L'unico attributo dell'helper tag di ambiente, names, è un elenco delimitato da virgole di nomi di ambiente.The Environment Tag Helper's single attribute, names, is a comma-separated list of environment names. Se nessuno dei nomi di ambiente specificato corrisponde all'ambiente corrente, viene eseguito il rendering del contenuto incluso.If any of the provided environment names match the current environment, the enclosed content is rendered.

Per una panoramica degli helper tag, vedere Helper tag in ASP.NET Core.For an overview of Tag Helpers, see Helper tag in ASP.NET Core.

Attributi dell'helper tag di ambienteEnvironment Tag Helper Attributes

nominames

names accetta un singolo nome di ambiente host o un elenco delimitato da virgole di nomi di ambiente, che attiva il rendering del contenuto.names accepts a single hosting environment name or a comma-separated list of hosting environment names that trigger the rendering of the enclosed content.

I valori di ambiente vengono confrontati con il valore corrente restituito da IHostingEnvironment.EnvironmentName.Environment values are compared to the current value returned by IHostingEnvironment.EnvironmentName. Il confronto non applica la distinzione tra maiuscole e minuscole.The comparison ignores case.

L'esempio seguente usa un helper tag di ambiente.The following example uses an Environment Tag Helper. Il rendering del contenuto viene eseguito se l'ambiente host è Staging o Production:The content is rendered if the hosting environment is Staging or Production:

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

Attributi include ed excludeinclude and exclude attributes

Gli attributi include ed exclude controllano il rendering del contenuto incluso in base ai nomi di ambiente host inclusi o esclusi.include & exclude attributes control rendering the enclosed content based on the included or excluded hosting environment names.

includeinclude

La proprietà include ha un comportamento simile all'attributo names.The include property exhibits similar behavior to the names attribute. Un ambiente elencato nel valore dell'attributo include deve corrispondere all'ambiente host dell'app (IHostingEnvironment.EnvironmentName) per il rendering del contenuto del tag <environment>.An environment listed in the include attribute value must match the app's hosting environment (IHostingEnvironment.EnvironmentName) to render the content of the <environment> tag.

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

excludeexclude

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.In contrast to the include attribute, the content of the <environment> tag is rendered when the hosting environment doesn't match an environment listed in the exclude attribute value.

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

Risorse aggiuntiveAdditional resources