Blazor:取代的 WebEventDescriptor.EventArgsType 屬性

WebEventDescriptor 類別是從 JavaScript 至 .NET 通訊事件的 Blazor 內部通訊協定部分。 此類別通常不是應用程式程式碼,而是平台作者使用。

從 ASP.NET Core 6.0 開始,新的 EventName 屬性會取代 WebEventDescriptor 上的 EventArgsType 屬性。 此變更不太可能影響任何應用程式程式碼,因為變更是低階平台實作詳細資料。

導入的版本

ASP.NET Core 6.0

舊的行為

在 ASP.NET Core 5.0 和更早版本中,屬性 EventArgsType 描述 DOM 事件類型群組的非標準 Blazor 特定類別名稱。 例如,clickmousedown 事件都對應 mouseEventArgsType 值。 同樣地,cutcopypaste 事件對應 clipboardEventArgsType 值。 這些類別名稱用來決定 .NET 類型是否用於還原序列化傳入事件引數資料。

新的行為

從 ASP.NET Core 6.0 開始,新屬性 EventName 只指定原始事件的名稱。 例如 clickmousedowncutcopypaste。 您不必再提供 Blazor 特定的類別名稱。 基於這個原因,系統會移除舊屬性 EventArgsType

變更原因

在提取要求 dotnet/aspnetcore#29993 中採用自訂事件引數類別的支援。 作為此支援的一部分,架構不再依賴符合預先定義類別集的所有事件。 架構目前只需知道原始事件名稱。

應用程式程式碼應該不受影響,所以不必變更。

如果組建自訂 Blazor 轉譯平台,您可能需要更新分派事件至 Renderer 的機制。 使用較簡單的邏輯提供原始事件名稱,取代事件類別的任何硬式編碼規則。

受影響的 API

WebEventDescriptor.EventArgsType