EnvironmentBoundary 클래스

정의

현재 호스팅 환경이 지정된 환경 이름 중 하나와 일치하는 경우에만 자식 콘텐츠를 렌더링하는 구성 요소입니다.

public sealed class EnvironmentBoundary : Microsoft.AspNetCore.Components.ComponentBase
type EnvironmentBoundary = class
    inherit ComponentBase
Public NotInheritable Class EnvironmentBoundary
Inherits ComponentBase
상속
EnvironmentBoundary

설명

이 구성 요소는 MVC 및 Razor Pages의 환경 태그 도우미와 유사합니다.

다음 예제에서는 환경에 따라 콘텐츠를 조건부로 렌더링하는 방법을 보여 줍니다.
<EnvironmentBoundary Include="Development">
<div class="alert alert-warning">
        You are running in Development mode. Debug features are enabled.
</div>
</EnvironmentBoundary>

<EnvironmentBoundary Include="Development, Staging">
<p>This is a pre-production environment.</p>
</EnvironmentBoundary>

<EnvironmentBoundary Exclude="Production">
<p>Debug information: @DateTime.Now</p>
</EnvironmentBoundary>

생성자

Name Description
EnvironmentBoundary()

현재 호스팅 환경이 지정된 환경 이름 중 하나와 일치하는 경우에만 자식 콘텐츠를 렌더링하는 구성 요소입니다.

속성

Name Description
Assets

애플리케이션에 ResourceAssetCollection 대한 값을 가져옵니다.

(다음에서 상속됨 ComponentBase)
AssignedRenderMode

이 구성 요소에 IComponentRenderMode 할당된 값을 가져옵니다.

(다음에서 상속됨 ComponentBase)
ChildContent

환경이 일치할 때 렌더링할 콘텐츠를 가져오거나 설정합니다.

Exclude

콘텐츠가 렌더링되지 않는 환경 이름의 쉼표로 구분된 목록을 가져오거나 설정합니다.

Include

콘텐츠를 렌더링해야 하는 환경 이름의 쉼표로 구분된 목록을 가져오거나 설정합니다. 현재 환경도 Exclude 목록에 있으면 콘텐츠가 렌더링되지 않습니다.

RendererInfo

RendererInfo 실행 중인 구성 요소를 가져옵니다.

(다음에서 상속됨 ComponentBase)

메서드

Name Description
BuildRenderTree(RenderTreeBuilder)

제공된 RenderTreeBuilder구성 요소에 렌더링합니다.

(다음에서 상속됨 ComponentBase)
DispatchExceptionAsync(Exception)

제공된 exception 것이 이 구성 요소에 의해 throw되는 것으로 처리합니다. 이로 인해 바깥쪽 ErrorBoundary가 실패 상태로 전환됩니다. 바깥쪽 ErrorBoundary가 없으면 바깥쪽 렌더러의 예외로 간주됩니다.

이는 구성 요소 수명 주기 메서드 외부에서 예외가 발생하지만 구성 요소 수명 주기 메서드의 예외와 동일하게 처리하려는 경우에 유용합니다.

(다음에서 상속됨 ComponentBase)
InvokeAsync(Action)

연결된 렌더러의 동기화 컨텍스트에서 제공된 작업 항목을 실행합니다.

(다음에서 상속됨 ComponentBase)
InvokeAsync(Func<Task>)

연결된 렌더러의 동기화 컨텍스트에서 제공된 작업 항목을 실행합니다.

(다음에서 상속됨 ComponentBase)
OnAfterRender(Boolean)

구성 요소가 대화형으로 렌더링되고 UI가 업데이트를 완료할 때마다 호출되는 메서드(예: 요소가 브라우저 DOM에 추가된 후). 모든 ElementReference 필드는 실행될 때까지 채워집니다.

이 메서드는 사전 렌더링 또는 서버 쪽 렌더링 중에 호출되지 않습니다. 이러한 프로세스는 라이브 브라우저 DOM에 연결되지 않고 DOM이 업데이트되기 전에 이미 완료되었기 때문입니다.

(다음에서 상속됨 ComponentBase)
OnAfterRenderAsync(Boolean)

구성 요소가 대화형으로 렌더링되고 UI가 업데이트를 완료할 때마다 호출되는 메서드(예: 요소가 브라우저 DOM에 추가된 후). 모든 ElementReference 필드는 실행될 때까지 채워집니다.

이 메서드는 사전 렌더링 또는 서버 쪽 렌더링 중에 호출되지 않습니다. 이러한 프로세스는 라이브 브라우저 DOM에 연결되지 않고 DOM이 업데이트되기 전에 이미 완료되었기 때문입니다.

이 경우 무한 렌더링 루프가 발생하므로 반환 Task된 항목이 완료된 후에는 구성 요소가 자동으로 다시 렌더링되지 않습니다.

(다음에서 상속됨 ComponentBase)
OnInitialized()

렌더링 트리의 부모로부터 초기 매개 변수를 수신하여 구성 요소를 시작할 준비가 되면 호출되는 메서드입니다.

(다음에서 상속됨 ComponentBase)
OnInitializedAsync()

렌더링 트리의 부모로부터 초기 매개 변수를 수신하여 구성 요소를 시작할 준비가 되면 호출되는 메서드입니다.

비동기 작업을 수행하고 해당 작업이 완료될 때 구성 요소를 새로 고치려는 경우 이 메서드를 재정의합니다.

(다음에서 상속됨 ComponentBase)
OnParametersSet()

구성 요소가 렌더링 트리에서 부모로부터 매개 변수를 수신하고 들어오는 값이 속성에 할당되었을 때 호출되는 메서드입니다.

(다음에서 상속됨 ComponentBase)
OnParametersSetAsync()

구성 요소가 렌더링 트리에서 부모로부터 매개 변수를 수신하고 들어오는 값이 속성에 할당되었을 때 호출되는 메서드입니다.

(다음에서 상속됨 ComponentBase)
SetParametersAsync(ParameterView)

렌더링 트리에서 구성 요소의 부모가 제공하는 매개 변수를 설정합니다.

(다음에서 상속됨 ComponentBase)
ShouldRender()

구성 요소가 렌더링되어야 하는지 여부를 나타내는 플래그를 반환합니다.

(다음에서 상속됨 ComponentBase)
StateHasChanged()

구성 요소에 상태가 변경되었음을 알 수 있습니다. 해당하는 경우 구성 요소가 다시 렌더링됩니다.

(다음에서 상속됨 ComponentBase)

명시적 인터페이스 구현

Name Description
IComponent.Attach(RenderHandle)

현재 호스팅 환경이 지정된 환경 이름 중 하나와 일치하는 경우에만 자식 콘텐츠를 렌더링하는 구성 요소입니다.

(다음에서 상속됨 ComponentBase)
IHandleAfterRender.OnAfterRenderAsync()

현재 호스팅 환경이 지정된 환경 이름 중 하나와 일치하는 경우에만 자식 콘텐츠를 렌더링하는 구성 요소입니다.

(다음에서 상속됨 ComponentBase)
IHandleEvent.HandleEventAsync(EventCallbackWorkItem, Object)

현재 호스팅 환경이 지정된 환경 이름 중 하나와 일치하는 경우에만 자식 콘텐츠를 렌더링하는 구성 요소입니다.

(다음에서 상속됨 ComponentBase)

적용 대상