ASP.NET Core 中的環境標籤協助程式

  • 發行項

作者：Peter Kellner 和 Hisham Bin Ateya

環境標籤協助程式依據目前的主控環境，有條件地轉譯含括內容。 環境標籤協助程式的單一屬性 names，是以逗號分隔的環境名稱清單。 如果任何提供的環境名稱符合目前環境，則會轉譯含括的內容。

如需標籤協助程式的概觀，請參閱 ASP.NET Core 中的標籤協助程式。

環境標籤協助程式屬性

名稱

names 會接受單一主控環境名稱或以逗號分隔的主控環境名稱清單，這些名稱會觸發轉譯含括的內容。

環境值會與 IWebHostEnvironment.EnvironmentName 所傳回的目前值進行比較。 比較會忽略大小寫。

下列範例使用環境標籤協助程式。 如果主控環境為「暫存」或「生產」，將會轉譯內容：

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

include 和 exclude 屬性

include 和 exclude 屬性控制項會根據包含或排除的裝載環境名稱來轉譯封入的內容。

include

include 屬性會表現出類似 names 屬性的行為。 include 屬性值中列出的環境必須與應用程式的裝載環境 (IWebHostEnvironment.EnvironmentName) 相符，才能轉譯 <environment> 標籤的內容。

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

排除

與 include 屬性相反，當主控環境與 exclude 屬性值中列出的環境不相符時，將轉譯 <environment> 標記的內容。

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

其他資源