Umgebungstaghilfsprogramm in ASP.NET CoreEnvironment Tag Helper in ASP.NET Core

Von Peter Kellner, Hisham Bin Ateya und Luke LathamBy Peter Kellner, Hisham Bin Ateya, and Luke Latham

Basierend auf der aktuellen Hostingumgebung rendert das Environment-Taghilfsprogramm den von ihm eingeschlossenen Inhalt unter Vorbehalt.The Environment Tag Helper conditionally renders its enclosed content based on the current hosting environment. Das einzelne Attribut names des Environment-Taghilfsprogramm ist eine durch Trennzeichen getrennte Liste von Umgebungsnamen.The Environment Tag Helper's single attribute, names, is a comma-separated list of environment names. Wenn die Namen der bereitgestellten Umgebung der aktuellen Umgebung entsprechen, wird der eingeschlossene Inhalt gerendert.If any of the provided environment names match the current environment, the enclosed content is rendered.

Eine Übersicht der Taghilfsprogramme finden Sie unter Taghilfsprogramme in ASP.NET Core.For an overview of Tag Helpers, see Taghilfsprogramme in ASP.NET Core.

Attribute von UmgebungstaghilfsprogrammenEnvironment Tag Helper Attributes

Namennames

names akzeptiert den Namen einer einzelnen Hostingumgebung oder eine durch Trennzeichen getrennte Liste mit Namen von Hostingumgebungen, die das Rendering des eingeschlossenen Inhalts auslösen.names accepts a single hosting environment name or a comma-separated list of hosting environment names that trigger the rendering of the enclosed content.

Umgebungswerte werden im Vergleich zum aktuellen Wert von IHostingEnvironment.EnvironmentName zurückgegeben.Environment values are compared to the current value returned by IHostingEnvironment.EnvironmentName. Bei dem Vergleich wird die Groß-/Kleinschreibung ignoriert.The comparison ignores case.

Im folgenden Beispiel wird ein Environment-Taghilfsprogramm verwendet:The following example uses an Environment Tag Helper. Der Inhalt wird wiedergegeben, wenn es sich bei der Hostumgebung um eine Staging- oder Produktionsumgebung handelt: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>

Die Attribute „include“ und „exclude“include and exclude attributes

Die Attribute include & exclude steuern das Rendern des eingeschlossenen Inhalts anhand der eingeschlossenen bzw. ausgeschlossenen Namen von Hostingumgebungen.include & exclude attributes control rendering the enclosed content based on the included or excluded hosting environment names.

includeinclude

Die include-Eigenschaft zeigt ein ähnliches Verhalten wie das Attribut names.The include property exhibits similar behavior to the names attribute. Eine im Attributwert include aufgeführte Umgebung muss der App-Hostingumgebung (IHostingEnvironment.EnvironmentName) entsprechen, damit der Inhalt des Tags <environment> gerendert werden kann.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

Im Gegensatz zum Attribut include wird der Inhalt des <environment>-Tags gerendert, wenn die Hostingumgebung nicht einer Umgebung entspricht, die im Attributwert exclude aufgeführt wird.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>

Zusätzliche RessourcenAdditional resources