ASP.NET Core の環境タグ ヘルパー

著者: Peter Kellner、Hisham Bin Ateya

環境タグ ヘルパーは、現在のホスティング環境に基づき、囲まれたコンテンツを条件付きで表示します。 環境タグ ヘルパーの 1 つの属性 names は、環境名のコンマ区切りリストです。 指定された環境名のいずれかが現在の環境と一致する場合、囲まれたコンテンツが表示されます。

タグ ヘルパーの概要については、「ASP.NET Core のタグ ヘルパー」を参照してください。

環境タグ ヘルパーの属性

names

names は、囲まれたコンテンツの表示をトリガーする単一のホスティング環境名またはホスティング環境名のコンマ区切りリストを受け入れます。

環境値は、IWebHostEnvironment.EnvironmentName によって返される現在の値と比較されます。 比較では大文字と小文字の区別は無視されます。

環境タグ ヘルパーを使用する例を次に示します。 ホスティング環境が Staging または Production の場合、コンテンツが表示されます。

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

include および exclude 属性

include および exclude 属性は、含めるまたは除外するホスティング環境名に基づいて、囲まれたコンテンツの表示を制御します。

include

include プロパティが示す動作は、names 属性と似ています。 <environment> タグの内容を表示するには、include 属性値に列記されている環境が、アプリのホスティング環境 (IWebHostEnvironment.EnvironmentName) と一致する必要があります。

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

除外

include 属性とは対照的に、<environment> タグの内容は、ホスティング環境が exclude 属性の値で列記されている環境と一致しない場合に表示されます。

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

その他の技術情報

• ASP.NET Core で複数の環境を使用する