feat: 增加参数检查逻辑开启本地存储时必须给 Name 参数

Author: ArgoZhang

src/components/BootstrapBlazor.DockView/Components/DockViewV2.razor.cs

@@ -185,6 +185,20 @@ protected override void OnInitialized()
         ThemeProviderService.ThemeChangedAsync += OnThemeChangedAsync;
     }
 
+    /// <summary>
+    /// <inheritdoc/>
+    /// </summary>
+    protected override void OnParametersSet()
+    {
+        base.OnParametersSet();
+
+        // 开启本体存储未提供 Name 时抛出异常提示
+        if (IsEnableLocalStorage && string.IsNullOrEmpty(Name))
+        {
+            throw new InvalidOperationException("Name must be provided when local storage is enabled.");
+        }
+    }
+
     /// <summary>
     /// <inheritdoc/>
     /// </summary>
@@ -195,19 +209,19 @@ protected override async Task OnAfterRenderAsync(bool firstRender)
 
         if (!firstRender)
         {
-            await InvokeVoidAsync("update", Id, GetOptions());
+            await InvokeVoidAsync("update", Id, GetDockViewConfig());
         }
     }
 
     /// <summary>
     /// <inheritdoc />
     /// </summary>
-    protected override Task InvokeInitAsync() => InvokeVoidAsync("init", Id, Interop, GetOptions());
+    protected override Task InvokeInitAsync() => InvokeVoidAsync("init", Id, Interop, GetDockViewConfig());
 
-    private DockViewConfig GetOptions() => new()
+    private DockViewConfig GetDockViewConfig() => new()
     {
-        EnableLocalStorage = EnableLocalStorage ?? _options.EnableLocalStorage ?? false,
-        LocalStorageKey = $"{GetPrefixKey()}-{Name}-{GetVersion()}",
+        EnableLocalStorage = IsEnableLocalStorage,
+        LocalStorageKey = LocalStorageKey,
         IsLock = IsLock,
         ShowLock = ShowLock,
         IsFloating = IsFloating,
@@ -226,6 +240,10 @@ protected override async Task OnAfterRenderAsync(bool firstRender)
         LoadTabs = nameof(LoadTabs)
     };
 
+    private bool IsEnableLocalStorage => EnableLocalStorage ?? _options.EnableLocalStorage ?? false;
+
+    private string? LocalStorageKey => IsEnableLocalStorage ? $"{GetPrefixKey()}-{Name}-{GetVersion()}" : null;
+
     private string GetVersion() => Version ?? _options.Version ?? "v1";
 
     private string GetPrefixKey() => LocalStoragePrefix ?? _options.LocalStoragePrefix ?? "bb-dockview";
@@ -236,7 +254,7 @@ protected override async Task OnAfterRenderAsync(bool firstRender)
     /// </summary>
     public async Task Reset(string? layoutConfig = null)
     {
-        var options = GetOptions();
+        var options = GetDockViewConfig();
         if (layoutConfig != null)
         {
             options.LayoutConfig = layoutConfig;