語言

EnvironmentView 類別

定義

一個元件,只有當當前主機環境與指定環境名稱匹配時,才渲染其子內容。

public sealed class EnvironmentView : Microsoft.AspNetCore.Components.ComponentBase
type EnvironmentView = class
    inherit ComponentBase
Public NotInheritable Class EnvironmentView
Inherits ComponentBase
繼承
EnvironmentView

備註

此元件類似於 MVC 和 Razor Pages 中的環境標籤輔助器。

以下範例展示了如何根據環境條件渲染內容:
<EnvironmentView Include="Development">
<div class="alert alert-warning">
        You are running in Development mode. Debug features are enabled.
</div>
</EnvironmentView>

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

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

建構函式

名稱 Description
EnvironmentView()

一個元件,只有當當前主機環境與指定環境名稱匹配時,才渲染其子內容。

屬性

名稱 Description
Assets

申請時會得到。ResourceAssetCollection

(繼承來源 ComponentBase)
AssignedRenderMode

被 IComponentRenderMode 指派到這個元件。

(繼承來源 ComponentBase)
ChildContent

當環境匹配時,取得或設定內容要渲染。

Exclude

取得或設定一個逗號分隔的環境名稱清單,內容不會被渲染。

Include

取得或設定一個逗號分隔的環境名稱清單,內容應該在其中呈現。 如果目前環境也在 Exclude 列表中,內容將不會被渲染。

RendererInfo

讀取 RendererInfo 元件正在運行的狀態。

(繼承來源 ComponentBase)

方法

名稱 Description
BuildRenderTree(RenderTreeBuilder)

將元件渲染成所提供的 RenderTreeBuilder。

(繼承來源 ComponentBase)
DispatchExceptionAsync(Exception)

將所供應 exception 的訊號視為由此元件拋出。 這會導致封入 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)

明確介面實作

名稱 Description
IComponent.Attach(RenderHandle)

一個元件,只有當當前主機環境與指定環境名稱匹配時,才渲染其子內容。

(繼承來源 ComponentBase)
IHandleAfterRender.OnAfterRenderAsync()

一個元件,只有當當前主機環境與指定環境名稱匹配時,才渲染其子內容。

(繼承來源 ComponentBase)
IHandleEvent.HandleEventAsync(EventCallbackWorkItem, Object)

一個元件,只有當當前主機環境與指定環境名稱匹配時,才渲染其子內容。

(繼承來源 ComponentBase)

適用於