Pomocnik tagów środowiska w programie ASP.NET Core

Peter Kellner i Hisham Bin Ateya

Pomocnik tagu środowiska warunkowo renderuje ujętą zawartość na podstawie bieżącego środowiska hostingu. Pojedynczy atrybut pomocnika tagu środowiska , namesjest rozdzielaną przecinkami listą nazw środowisk. Jeśli dowolna z podanych nazw środowisk jest zgodna z bieżącym środowiskiem, ujęta zawartość jest renderowana.

Aby zapoznać się z omówieniem pomocników tagów, zobacz Pomocnicy tagów na platformie ASP.NET Core.

Atrybuty pomocnika tagów środowiska

nazwy

names akceptuje pojedynczą nazwę środowiska hostingu lub rozdzielaną przecinkami listę nazw środowisk hostingu, które wyzwalają renderowanie ujętej zawartości.

Wartości środowiska są porównywane z bieżącą wartością zwracaną przez IWebHostEnvironment.EnvironmentName. Porównanie ignoruje wielkość liter.

W poniższym przykładzie użyto pomocnika tagów środowiska. Zawartość jest renderowana, jeśli środowisko hostingu jest przejściowe lub produkcyjne:

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

dołączanie i wykluczanie atrybutów

include Kontrolka i exclude atrybutów renderuje ujętą zawartość na podstawie dołączonych lub wykluczonych nazw środowisk hostingu.

include

Właściwość include wykazuje podobne zachowanie do atrybutu names . Środowisko wymienione w wartości atrybutu include musi być zgodne ze środowiskiem hostingu aplikacji (IWebHostEnvironment.EnvironmentName), aby renderować zawartość tagu <environment> .

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

wykluczanie

W przeciwieństwie do atrybutu include zawartość tagu <environment> jest renderowana, gdy środowisko hostingu nie pasuje do środowiska wymienionego w wartości atrybutu exclude .

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

Dodatkowe zasoby

• Używanie wielu środowisk na platformie ASP.NET Core