EnvironmentBoundary 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
一個元件，只有當當前主機環境與指定環境名稱匹配時，才渲染其子內容。
public sealed class EnvironmentBoundary : Microsoft.AspNetCore.Components.ComponentBasetype EnvironmentBoundary = class
inherit ComponentBasePublic NotInheritable Class EnvironmentBoundary
Inherits ComponentBase- 繼承
備註
此元件類似於 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>
建構函式
| 名稱 | Description |
|---|---|
| EnvironmentBoundary() |
一個元件，只有當當前主機環境與指定環境名稱匹配時，才渲染其子內容。 |
屬性
| 名稱 | Description |
|---|---|
| Assets |
申請時會得到。ResourceAssetCollection (繼承來源 ComponentBase) |
| AssignedRenderMode |
被 IComponentRenderMode 指派到這個元件。 (繼承來源 ComponentBase) |
| ChildContent |
當環境匹配時，取得或設定內容要渲染。 |
| Exclude |
取得或設定一個逗號分隔的環境名稱清單，內容不會被渲染。 |
| Include |
取得或設定一個逗號分隔的環境名稱清單，內容應該在其中呈現。 如果目前環境也在 Exclude 列表中，內容將不會被渲染。 |
| RendererInfo |
讀取 RendererInfo 元件正在運行的狀態。 (繼承來源 ComponentBase) |
方法
| 名稱 | Description |
|---|---|
| BuildRenderTree(RenderTreeBuilder) |
將元件渲染成所提供的 RenderTreeBuilder。 (繼承來源 ComponentBase) |
| DispatchExceptionAsync(Exception) |
將所供應 這在元件生命週期方法之外發生例外時很有用，但你希望將其視為元件生命週期方法的例外。 (繼承來源 ComponentBase) |
| InvokeAsync(Action) |
在相關渲染器的同步上下文中執行所提供的工作項目。 (繼承來源 ComponentBase) |
| InvokeAsync(Func<Task>) |
在相關渲染器的同步上下文中執行所提供的工作項目。 (繼承來源 ComponentBase) |
| OnAfterRender(Boolean) |
每次元件互動式渲染且 UI 更新完成（例如元素加入瀏覽器 DOM 後）後，會呼叫方法。 任何 ElementReference 欄位在執行時都會被填滿。 此方法不會在預渲染或伺服器端渲染時被調用，因為這些程序未連接任何即時瀏覽器 DOM，且在 DOM 更新前已完成。 (繼承來源 ComponentBase) |
| OnAfterRenderAsync(Boolean) |
每次元件互動式渲染完且使用者介面更新完成（例如元素加入瀏覽器 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) |