Auxiliar de Marca de Ambiente no ASP.NET Core

  • Artigo

Por Peter Kellner e Hisham Bin Ateya

O Auxiliar de Marca de Ambiente renderiza condicionalmente seu conteúdo contido com base no ambiente de hospedagem atual. Atributo único do Auxiliar de Marca de Ambiente, names, é uma lista separada por vírgulas de nomes de ambiente. Se nenhum dos nomes de ambiente fornecido corresponder ao ambiente atual, o conteúdo contido será renderizado.

Para ter uma visão geral dos Auxiliares de Marcação, confira Auxiliares de Marcação no ASP.NET Core.

Atributos do Auxiliar de Marca de Ambiente

nomes

names aceita um único nome de ambiente de hospedagem ou uma lista separada por vírgula de nomes de ambiente de hospedagem que disparam a renderização do conteúdo contido.

Valores de ambiente são comparados com o valor atual retornado por IWebHostEnvironment.EnvironmentName. A comparação ignora o uso de maiúsculas.

O exemplo a seguir usa um Auxiliar de Marca de Ambiente. O conteúdo será renderizado se o ambiente de hospedagem for De Preparo ou de Produção:

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

incluir e excluir atributos

Os atributos include e exclude controlam a renderização do conteúdo incluído com base nos nomes de ambiente de hospedagem incluídos ou excluídos.

include

A propriedade include exibe um comportamento semelhante para o atributo names. Um ambiente listado no valor do atributo include deve corresponder ao ambiente de hospedagem do aplicativo (IWebHostEnvironment.EnvironmentName) para renderizar o conteúdo da marca <environment>.

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

excluir

Em contraste com o atributo include, o conteúdo da marcação <environment> é processado quando o ambiente de hospedagem não corresponde a um ambiente listado no valor do atributo exclude.

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

Recursos adicionais