共用方式為


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

作者:Peter KellnerHisham Bin Ateya

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

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

環境標籤協助程式屬性

名稱

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

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

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

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

include 和 exclude 屬性

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

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>

其他資源