在ASP.NET?Core 中，ModelMetadataDetailsProviders?是用于配置模型元數據提供程序的核心組件，它決定了如何解析和提供模型屬性的元數據（如數據類型、驗證規則、顯示名稱等）。以下是其詳細解析：

一、核心概念與作用

1. 模型元數據（ModelMetadata）

   • 描述模型屬性的元數據信息，包括：
     • 數據類型（如int、string）
     • 驗證特性（如[Required]、[MaxLength]）
     • 顯示名稱（如[Display(Name="用戶名")]）
     • 綁定源（如[FromForm]、[FromQuery]）

2. ModelMetadataDetailsProviders 的角色

   • 提供一個擴展點，允許注冊多個元數據提供程序，按順序處理并合并元數據。
   • 支持自定義元數據邏輯，例如從數據庫、配置文件或其他數據源動態生成元數據。

二、內置的元數據提供程序

ASP.NET?Core 默認包含以下主要的元數據提供程序：

提供程序類型	作用描述
DataAnnotationsMetadataProvider	從DataAnnotations特性（如[Required]、[Display]）中提取元數據。
ValidationMetadataProvider	提供數據驗證相關的元數據（如[Range]、[RegularExpression]）。
BindingMetadataProvider	提供綁定相關的元數據（如[BindRequired]、[FromQuery]）。
ConventionsMetadataProvider	應用約定（Conventions）定義的元數據（如控制器 / 動作選擇規則）。

三、自定義元數據提供程序

1. 實現 IModelMetadataDetailsProvider 接口

public class CustomMetadataProvider : IModelMetadataDetailsProvider
{public void CreateBindingMetadata(BindingMetadataProviderContext context){// 自定義綁定元數據（如設置默認綁定源）if (context.Key.Name == "Email"){context.BindingMetadata.BindingSource = BindingSource.Query;}}public void CreateDisplayMetadata(DisplayMetadataProviderContext context){// 自定義顯示元數據（如修改顯示名稱）if (context.Key.Name == "UserName"){context.DisplayMetadata.DisplayName = () => "用戶昵稱";}}public void CreateValidationMetadata(ValidationMetadataProviderContext context){// 自定義驗證元數據（如添加額外驗證規則）if (context.Key.Name == "Age"){context.ValidationMetadata.ValidatorMetadata.Add(new RangeAttribute(18, 100) { ErrorMessage = "年齡必須在18-100歲之間" });}}
}

2. 注冊自定義提供程序

在Startup.ConfigureServices中注冊：

services.AddControllersWithViews(options =>
{// 插入自定義元數據提供程序（優先級高于默認提供程序）options.ModelMetadataDetailsProviders.Add(new CustomMetadataProvider());
});

四、應用場景示例

1. 動態顯示名稱

從數據庫或配置文件獲取屬性的顯示名稱，而非硬編碼在[Display]特性中：

public class DatabaseDisplayMetadataProvider : IModelMetadataDetailsProvider
{private readonly IConfiguration _config;public DatabaseDisplayMetadataProvider(IConfiguration config){_config = config;}public void CreateDisplayMetadata(DisplayMetadataProviderContext context){// 從數據庫或配置中獲取顯示名稱var displayName = _config[$"DisplayNames:{context.Key.Name}"];if (!string.IsNullOrEmpty(displayName)){context.DisplayMetadata.DisplayName = () => displayName;}}// 其他方法實現...
}

2. 基于角色的驗證規則

根據用戶角色動態調整驗證規則：

public class RoleBasedValidationProvider : IModelMetadataDetailsProvider
{private readonly IHttpContextAccessor _httpContextAccessor;public RoleBasedValidationProvider(IHttpContextAccessor httpContextAccessor){_httpContextAccessor = httpContextAccessor;}public void CreateValidationMetadata(ValidationMetadataProviderContext context){var user = _httpContextAccessor.HttpContext.User;// 管理員角色放寬驗證if (user.IsInRole("Admin") && context.Key.Name == "Price"){context.ValidationMetadata.ValidatorMetadata.Clear(); // 移除所有驗證}}// 其他方法實現...
}

五、執行順序與優先級

• 元數據提供程序按注冊順序執行，后注冊的提供程序可以覆蓋前面的元數據。
• 示例：先應用默認提供程序，再應用自定義提供程序：

options.ModelMetadataDetailsProviders.Add(new CustomMetadataProvider()); // 后執行，優先級高
options.ModelMetadataDetailsProviders.Insert(0, new AnotherProvider());  // 先執行，優先級低

六、內置的元數據提供程序

? ExcludeBindingMetadataProvider?是一個內置的元數據提供程序，用于排除特定類型或屬性的模型綁定。你提供的代碼?options.ModelMetadataDetailsProviders.Add(new ExcludeBindingMetadataProvider(typeof(IModelStateService)));?的作用是阻止控制器參數綁定到?IModelStateService?類型的屬性。

1. 阻止模型綁定
   當你注冊?ExcludeBindingMetadataProvider?并指定某個類型（如?IModelStateService）時，ASP.NET?Core 會：

   • 忽略 HTTP 請求中與該類型相關的數據（如表單字段、查詢字符串）。
   • 防止該類型的屬性被模型綁定器填充值。

2. 實現機制
   ExcludeBindingMetadataProvider?通過修改元數據中的?BindingMetadata.IsBindingAllowed?屬性為?false，告訴模型綁定器跳過該類型的屬性。

3. 排除服務接口的綁定

   如果你在控制器中注入了服務（如?IModelStateService），但不想讓它被請求數據綁定：

   public class MyController : Controller
   {private readonly IModelStateService _service;// 構造函數注入服務（但不希望從請求中綁定）public MyController(IModelStateService service){_service = service;}[HttpPost]public IActionResult Submit([FromForm] MyModel model){// 使用_service處理業務邏輯_service.Validate(model);return Ok();}
   }

   ? ? ? ? 通過?ExcludeBindingMetadataProvider?排除?IModelStateService，可防止攻擊者通過請求參數偽造服務實例。

4. 排除敏感屬性的綁定

如果你有一個包含敏感字段（如?IsAdmin、PasswordHash）的模型，可排除這些屬性的綁定：

// 全局排除IsAdmin屬性的綁定
options.ModelMetadataDetailsProviders.Add(new ExcludeBindingMetadataProvider("IsAdmin"));

這比在每個模型屬性上添加?[BindNever]?特性更高效。

七、與其他組件的關系

組件	與 ModelMetadataDetailsProviders 的關系
ModelBinder	使用元數據確定如何綁定數據（如類型轉換、綁定源）。
DataAnnotations	元數據提供程序會解析DataAnnotations特性并生成對應元數據。
ModelValidator	使用元數據中的驗證規則執行模型驗證。
Razor 視圖	通過元數據獲取屬性的顯示名稱、驗證消息等，用于生成 HTML 標簽（如asp-for）。

八、注意事項

1. 性能考量
   避免在元數據提供程序中執行耗時操作（如數據庫查詢），可考慮緩存策略。

2. 線程安全
   元數據提供程序實例通常是單例的，確保實現線程安全。

3. 與 DataAnnotations 的兼容性
   自定義提供程序應與DataAnnotations特性協同工作，而非完全替代。

4. 元數據緩存
   框架會緩存元數據，修改模型類后需重啟應用才能生效。

總結

ModelMetadataDetailsProviders?是ASP.NET?Core 中擴展模型元數據的強大機制，通過自定義元數據提供程序，你可以：

• 動態生成顯示名稱、驗證規則等元數據。
• 基于運行時條件（如用戶角色、配置）調整元數據。
• 整合外部數據源（如數據庫、配置文件）的元數據。

合理使用這一機制，可以實現更靈活、更動態的模型元數據管理，提升應用的可擴展性和可維護性。