? ? ? ? 在 Blazor 應用程序中，AuthenticationState 是一個核心概念，用于表示用戶的身份驗證狀態。它提供有關當前用戶的信息，例如是否已登錄、用戶的身份信息（如用戶名、角色等）。

AuthenticationState 通常由 AuthenticationStateProvider 提供，Blazor 使用它來管理和傳播用戶身份驗證的上下文。

---

AuthenticationState 的結構

? ?AuthenticationState 是一個簡單的類，包含一個 ClaimsPrincipal 對象，表示用戶的身份和角色信息：

Public class AuthenticationState 
{ public ClaimsPrincipal User { get; } public AuthenticationState(ClaimsPrincipal user) { User = user; } 
} 

• User：一個 ClaimsPrincipal 對象，包含用戶的身份驗證信息和聲明（Claims）。
  • 如果用戶已認證，User.Identity.IsAuthenticated 返回 true。
  • 如果用戶未認證，User.Identity.IsAuthenticated 返回 false。

---

使用場景

? ? ? ? ? Blazor 使用 AuthenticationState 來管理用戶的身份狀態，常見的使用場景包括：

1. 顯示用戶信息：顯示當前登錄用戶的姓名、角色等。
2. 條件顯示內容：根據用戶是否登錄或其角色顯示不同的內容。
3. 授權控制：使用 Blazor 的 [Authorize] 特性保護組件或頁面，確保只有特定用戶能夠訪問。

---

配合 AuthenticationStateProvider

? ? ? ? Blazor 中，AuthenticationState 是通過 AuthenticationStateProvider 提供的。框架內置了以下兩種身份驗證狀態提供程序：

1. ServerAuthenticationStateProvider：適用于 Blazor Server。
2. RemoteAuthenticationStateProvider：適用于 Blazor WebAssembly，與遠程身份驗證服務交互。

? ? ? ?開發者可以實現自定義的 AuthenticationStateProvider 來提供自定義的認證邏輯。

---

示例：如何獲取 AuthenticationState

1. 通過依賴注入

? ? ? ? 在組件中，可以通過注入 AuthenticationStateProvider 或 Task<AuthenticationState> 獲取用戶的身份狀態。

@inject AuthenticationStateProvider AuthenticationStateProvider 
<button @onclick="CheckAuthenticationState">檢查認證狀態</button> 
@code 
{ private async Task CheckAuthenticationState() { var authState = await AuthenticationStateProvider.GetAuthenticationStateAsync(); var user = authState.User; if (user.Identity != null && user.Identity.IsAuthenticated) { Console.WriteLine($"用戶已登錄，用戶名：{user.Identity.Name}"); } else { Console.WriteLine("用戶未登錄"); } } 
} 

2. 使用 AuthorizeView

? ? ? ? Blazor 提供了一個內置組件 AuthorizeView，可以根據 AuthenticationState 自動顯示不同的內容：

<AuthorizeView> <Authorized> <p>歡迎, @context.User.Identity.Name!</p> </Authorized> <NotAuthorized> <p>請登錄以訪問更多內容。</p> </NotAuthorized> 
</AuthorizeView> 

• Authorized：用戶已登錄時顯示的內容。
• NotAuthorized：用戶未登錄時顯示的內容。

---

工作原理

1. 身份驗證狀態的初始化
   AuthenticationStateProvider 提供用戶的身份驗證狀態，它通過實現 GetAuthenticationStateAsync 方法來生成一個 AuthenticationState。

2. 狀態的傳播
   使用 CascadingAuthenticationState 組件將 AuthenticationState 注入到整個應用的組件樹中。

3. 組件訪問
   各組件可以通過依賴注入直接訪問 AuthenticationState 或使用內置的授權組件（如 AuthorizeView）來動態響應用戶的認證狀態。

---

典型應用場景

1. 權限管理
   根據用戶角色控制頁面或功能的可見性，例如管理員才能訪問某些頁面。

2. 用戶個性化
   顯示用戶相關的信息，如用戶名或個性化內容。

3. 安全性
   確保未經授權的用戶無法訪問受保護的資源。