Condividi tramite


EnvironmentBoundary Classe

Definizione

Componente che esegue il rendering del contenuto figlio solo quando l'ambiente host corrente corrisponde a uno dei nomi di ambiente specificati.

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

Commenti

Questo componente è simile all'helper tag di ambiente in MVC e Razor Pages.

L'esempio seguente illustra come eseguire il rendering condizionale del contenuto in base all'ambiente:
<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>

Costruttori

Nome Descrizione
EnvironmentBoundary()

Componente che esegue il rendering del contenuto figlio solo quando l'ambiente host corrente corrisponde a uno dei nomi di ambiente specificati.

Proprietà

Nome Descrizione
Assets

Ottiene l'oggetto ResourceAssetCollection per l'applicazione.

(Ereditato da ComponentBase)
AssignedRenderMode

Ottiene l'oggetto IComponentRenderMode assegnato a questo componente.

(Ereditato da ComponentBase)
ChildContent

Ottiene o imposta il contenuto di cui eseguire il rendering quando l'ambiente corrisponde.

Exclude

Ottiene o imposta un elenco delimitato da virgole di nomi di ambiente in cui non verrà eseguito il rendering del contenuto.

Include

Ottiene o imposta un elenco delimitato da virgole di nomi di ambiente in cui deve essere eseguito il rendering del contenuto. Se l'ambiente corrente è incluso anche nell'elenco Exclude , il contenuto non verrà sottoposto a rendering.

RendererInfo

Ottiene il RendererInfo componente in esecuzione.

(Ereditato da ComponentBase)

Metodi

Nome Descrizione
BuildRenderTree(RenderTreeBuilder)

Esegue il rendering del componente nell'oggetto fornito RenderTreeBuilder.

(Ereditato da ComponentBase)
DispatchExceptionAsync(Exception)

Considera l'oggetto fornito exception come generato da questo componente. In questo modo, l'inclusione di ErrorBoundary passerà a uno stato di errore. Se non è presente alcuna inclusione di ErrorBoundary, verrà considerata un'eccezione dal renderer contenitore.

Ciò è utile se si verifica un'eccezione all'esterno dei metodi del ciclo di vita del componente, ma si vuole considerarla come un'eccezione da un metodo del ciclo di vita del componente.

(Ereditato da ComponentBase)
InvokeAsync(Action)

Esegue l'elemento di lavoro fornito nel contesto di sincronizzazione del renderer associato.

(Ereditato da ComponentBase)
InvokeAsync(Func<Task>)

Esegue l'elemento di lavoro fornito nel contesto di sincronizzazione del renderer associato.

(Ereditato da ComponentBase)
OnAfterRender(Boolean)

Metodo richiamato dopo ogni volta che il rendering del componente è stato eseguito in modo interattivo e l'interfaccia utente ha terminato l'aggiornamento (ad esempio, dopo l'aggiunta di elementi al DOM del browser). Tutti i ElementReference campi verranno popolati dall'ora di esecuzione.

Questo metodo non viene richiamato durante il prerendering o il rendering sul lato server, perché tali processi non sono collegati a alcun DOM del browser attivo e sono già stati completati prima dell'aggiornamento del DOM.

(Ereditato da ComponentBase)
OnAfterRenderAsync(Boolean)

Metodo richiamato dopo ogni volta che il rendering del componente è stato eseguito in modo interattivo e l'interfaccia utente ha terminato l'aggiornamento (ad esempio, dopo l'aggiunta di elementi al DOM del browser). Tutti i ElementReference campi verranno popolati dall'ora di esecuzione.

Questo metodo non viene richiamato durante il prerendering o il rendering sul lato server, perché tali processi non sono collegati a alcun DOM del browser attivo e sono già stati completati prima dell'aggiornamento del DOM.

Si noti che il componente non esegue automaticamente il rendering dopo il completamento di qualsiasi oggetto restituito Task, perché ciò causerebbe un ciclo di rendering infinito.

(Ereditato da ComponentBase)
OnInitialized()

Metodo richiamato quando il componente è pronto per l'avvio, dopo aver ricevuto i parametri iniziali dal relativo elemento padre nell'albero di rendering.

(Ereditato da ComponentBase)
OnInitializedAsync()

Metodo richiamato quando il componente è pronto per l'avvio, dopo aver ricevuto i parametri iniziali dal relativo elemento padre nell'albero di rendering.

Eseguire l'override di questo metodo se si eseguirà un'operazione asincrona e si desidera che il componente venga aggiornato al termine dell'operazione.

(Ereditato da ComponentBase)
OnParametersSet()

Metodo richiamato quando il componente ha ricevuto parametri dal relativo elemento padre nell'albero di rendering e i valori in ingresso sono stati assegnati alle proprietà.

(Ereditato da ComponentBase)
OnParametersSetAsync()

Metodo richiamato quando il componente ha ricevuto parametri dal relativo elemento padre nell'albero di rendering e i valori in ingresso sono stati assegnati alle proprietà.

(Ereditato da ComponentBase)
SetParametersAsync(ParameterView)

Imposta i parametri forniti dall'elemento padre del componente nell'albero di rendering.

(Ereditato da ComponentBase)
ShouldRender()

Restituisce un flag per indicare se il componente deve eseguire il rendering.

(Ereditato da ComponentBase)
StateHasChanged()

Notifica al componente che il relativo stato è stato modificato. Se applicabile, il rendering del componente verrà eseguito di nuovo.

(Ereditato da ComponentBase)

Implementazioni dell'interfaccia esplicita

Nome Descrizione
IComponent.Attach(RenderHandle)

Componente che esegue il rendering del contenuto figlio solo quando l'ambiente host corrente corrisponde a uno dei nomi di ambiente specificati.

(Ereditato da ComponentBase)
IHandleAfterRender.OnAfterRenderAsync()

Componente che esegue il rendering del contenuto figlio solo quando l'ambiente host corrente corrisponde a uno dei nomi di ambiente specificati.

(Ereditato da ComponentBase)
IHandleEvent.HandleEventAsync(EventCallbackWorkItem, Object)

Componente che esegue il rendering del contenuto figlio solo quando l'ambiente host corrente corrisponde a uno dei nomi di ambiente specificati.

(Ereditato da ComponentBase)

Si applica a