Blazor 生命周期

執行周期

1. SetParametersAsync

2. OnInitializedAsync（調用兩次） 和 OnInitialized；

3. OnParametersSetAsync 或 OnParametersSet；

4. OnAfterRenderAsync 和 OnAfterRender；

5. 每次組件呈現都會調用ShouldRender；

各周期解析

SetParametersAsync

每次調用 SetParametersAsync 時，ParameterView 都包含整個參數值集。

SetParametersAsync 的預設實現使用 [Parameter] 或 [CascadingParameter] 特性（在 ParameterView 中具有對應的值）設置每個屬性的值。 在 ParameterView 中沒有對應值的參數保持不變。

如果未調用 base.SetParametersAync，則自定義代碼可使用任何需要的方式解釋傳入的參數值。 例如，不要求將傳入參數分配給類的屬性。

如果設置有事件處理程式，處置時會將其解除掛接。 有關詳細信息，請參閱使用 IDisposable 處置組件部分。

public override async Task SetParametersAsync(ParameterView parameters)
{
    await ...

    await base.SetParametersAsync(parameters);
}

OnInitializedAsync 和 OnInitialized

SetParametersAsync 中的組件在從其父組件接收初始參數後初始化，此時，將調用 OnInitializedAsync 和 OnInitialized。

在組件執行非同步操作時使用 OnInitializedAsync，並應在操作完成後刷新。

對於同步操作，替代 OnInitialized：

預呈現其內容的 Blazor Server 應用調用 OnInitializedAsync 兩次：

• 在組件最初作為頁面的一部分靜態呈現時調用一次。

• 在瀏覽器重新建立與伺服器的連接時調用第二次。

為了防止 OnInitializedAsync 中的開發人員代碼運行兩次，請參閱預呈現後的有狀態重新連接部分。

在 Blazor Server 應用進行預呈現時，由於尚未建立與瀏覽器的連接，無法執行調用 JavaScript 等特定操作。 預呈現時，組件可能需要進行不同的呈現。 有關詳細信息，請參閱檢測應用何時預呈現部分。

如果設置有事件處理程式，處置時會將其解除掛接。

備註

應用參數和屬性值時，非同步操作必須在 OnParametersSetAsync 生命周期事件期間發生。

protected override void OnInitialized()
{
    ...
}

protected override async Task OnInitializedAsync()
{
    await ...
}

OnParametersSetAsync 或 OnParametersSet

在以下情況下調用：

在 OnInitializedAsync 或 OnInitialized 中初始化組件後。

當父組件重新呈現並提供以下內容時：

• 至少一個參數已更改的唯一已知基元不可變類型。

• 任何複雜類型的參數。 框架無法知道複雜類型參數的值是否在內部發生了改變，因此，它將參數集視為已更改。

備註

應用參數和屬性值時，非同步操作必須在 OnParametersSetAsync 生命周期事件期間發生。

protected override async Task OnParametersSetAsync()
{
    await ...
}

protected override void OnParametersSet()
{
    ...
}