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 특성과 달리, <environment> 태그의 콘텐츠는 호스팅 환경이 exclude 특성 값에 나열된 환경과 일치하지 않을 경우 렌더링됩니다.

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

추가 리소스